Como o Service Connector ajuda o Azure Functions a se conectar a serviços
O Azure Functions é um dos serviços de computação suportados pelo Service Connector. Recomendamos o uso de associações para conectar o Azure Functions a outros serviços, embora você também possa usar SDKs de cliente. Este artigo tem como objetivo ajudá-lo a entender:
- A relação entre as ligações do Service Connector e Functions.
- O processo usado pelo Service Connector para conectar o Functions a outros serviços do Azure usando associações ou o SDK.
- As responsabilidades assumidas pelo Service Connector e pelos usuários, respectivamente, em cada cenário.
Pré-requisitos
- Este guia pressupõe que você já conheça os conceitos básicos do Service Connector.
- Este guia pressupõe que você conheça os conceitos apresentados no guia do desenvolvedor do Azure Functions e como conectar uma função aos serviços do Azure.
Ligações do Service Connector e do Azure Functions
Ligações no Azure Functions
Uma associação é um conceito usado pelo Azure Functions, com o objetivo de fornecer uma maneira simples de conectar funções a serviços sem precisar trabalhar com SDKs de cliente em códigos de função.
A vinculação pode oferecer suporte a entradas, saídas e gatilhos. As associações permitem configurar a conexão com os serviços para que o host do Functions possa lidar com o acesso a dados para você. Para obter mais informações, consulte Gatilhos e conceitos de associações do Azure Functions.
A vinculação de função oferece suporte a tipos de autenticação secreto/de conexão e de autenticação baseada em identidade.
Conector do Serviço
O Service Connector é um serviço do Azure que ajuda os desenvolvedores a conectar facilmente serviços de computação a serviços de suporte de destino. O Azure Functions é um dos serviços de computação suportados pelo Service Connector.
Em comparação com uma associação de função, que é mais como um conceito logicamente abstraído, o Service Connector é um serviço do Azure no qual você pode operar diretamente. Ele fornece APIs para todo o ciclo de vida de uma conexão, como create, , deletevalidate integridade e list configurations.
O Service Connector também oferece suporte a tipos de autenticação secreto/cadeia de conexão e autenticação baseada em identidade.
Conexão em uma associação do Azure Functions
Em Associações de funções, connection é uma propriedade definida em um arquivo de vinculação (geralmente o function.json arquivo) na pasta de funções. Ele define o nome ou prefixo das configurações do aplicativo que será usado pelo tempo de execução de vinculação para autenticar os serviços de destino.
Conexão no Service Connector
A connection no Service Connector refere-se a um recurso específico do Azure que pertence ao Service Connector.
As connection ligações usadas pelo Azure Functions correspondem às configuration name usadas pelo Service Connector. O nome da configuração refere-se aos nomes de chave de configuração do aplicativo que o Service Connect salva nas configurações dos serviços de computação.
Conectando o Azure Functions a outros serviços de nuvem usando o Service Connector
O Service Connector reduz a quantidade de esforço necessária para conectar o Azure Functions a serviços de nuvem usando associações ou SDKs. Ele assume as configurações de recursos de nuvem, como Configurações de aplicativos, rede, identidade e atribuição de permissões, para que os usuários possam se concentrar nas lógicas de negócios de função. As seções a seguir descrevem como o Service Connector ajuda a simplificar as conexões de função com diferentes mecanismos de conexão e métodos de autenticação.
Associação
- Cadeia de conexão/segredo
| Cenário | Operação | Descrição | Sem conector de serviço | Com conector de serviço |
|---|---|---|---|---|
| Projeto local | Adicionar associação | Adicione uma associação em uma função de acordo com o tipo de serviço de destino e o tipo de associação (in/out/trigger). | Usuário | Usuário |
| Consumir vinculação | Defina uma cadeia de conexão para autenticação no local.settings.jsone altere o código da função para consumir a variável definida na associação. |
Usuário | Usuário | |
| Recurso de nuvem | Definir configurações de aplicativo | Configure a cadeia de conexão como uma configuração de aplicativo nas configurações do recurso de função. | Usuário | Conector do Serviço |
| Configurar a rede | Verifique se a configuração de rede do serviço de destino permite o acesso a partir do recurso de função. | Usuário | Conector do Serviço |
- Autenticação baseada em identidade
| Cenário | Operação | Descrição | Sem conector de serviço | Com conector de serviço |
|---|---|---|---|---|
| Projeto local | Adicionar associação | Adicione uma associação em uma função de acordo com o tipo de serviço de destino e o tipo de associação (in/out/trigger). | Usuário | Usuário |
| Consumir vinculação | Defina uma cadeia de conexão para autenticação no local.settings.jsone altere o código da função para consumir a variável definida na associação. |
Usuário | Usuário | |
| Recurso de nuvem | Definir configurações de aplicativo | Defina as configurações de identidade da Função do Azure, como pontos de extremidade de serviço. | Usuário | Conector do Serviço |
| Configurar a rede | Verifique se a configuração de rede do serviço de destino permite o acesso a partir do recurso de função. | Usuário | Conector do Serviço | |
| Configurar identidade | Verifique se a identidade do sistema está habilitada ao usar a identidade do sistema para autenticação. | Usuário | Conector do Serviço | |
| Atribuição de permissão | Atribua as funções de identidade necessárias para que ele possa acessar o serviço de destino. | Usuário | Conector do Serviço |
Ao usar o Service Connector com ligações de função, preste atenção especial ao nome da chave da função configurado pelo Service Connector. Verifique se é o mesmo nome de chave definido na connection propriedade no arquivo de vinculação. Se for diferente, altere o nome no arquivo de associação ou use o recurso do customize keys Service Connector para personalizar os nomes de configuração padrão do Service Connector.
.
- Cadeia de conexão/segredo
| Cenário | Operação | Descrição | Sem conector de serviço | Com conector de serviço |
|---|---|---|---|---|
| Projeto local | Adicionar dependência | Adicione o pacote de dependência de acordo com o serviço de destino e seu tempo de execução. | Usuário | Usuário |
| Iniciar cliente SDK | Definir cadeia de conexão para autenticação no local.settings.json. Inicie o SDK do serviço de destino usando uma cadeia de conexão. |
Usuário | Usuário | |
| Recurso de nuvem | Definir configurações de aplicativo | Configure uma cadeia de conexão como uma configuração de aplicativo na configuração da função. | Usuário | Conector do Serviço |
| Configurar a rede | Verifique se a configuração de rede do serviço de destino permite o acesso a partir do recurso de função. | Usuário | Conector do Serviço |
- Autenticação baseada em identidade
| Cenário | Operação | Descrição | Sem conector de serviço | Com conector de serviço |
|---|---|---|---|---|
| Projeto local | Adicionar dependência | Adicione o pacote de dependência de acordo com o serviço de destino e seu tempo de execução. | Usuário | Usuário |
| Iniciar cliente SDK | Definir cadeia de conexão para autenticação no local.settings.json. Inicie o SDK do serviço de destino usando uma cadeia de conexão. |
Usuário | Usuário | |
| Recurso de nuvem | Definir configurações de aplicativo | Configure uma cadeia de conexão como uma configuração de aplicativo na configuração da função. | Usuário | Conector do Serviço |
| Configurar a rede | Verifique se a configuração de rede do serviço de destino permite o acesso a partir do recurso de função. | Usuário | Conector do Serviço | |
| Configurar identidade | Verifique se a identidade do sistema está habilitada ao usar a identidade do sistema para autenticação. | Usuário | Conector do Serviço | |
| Atribuição de permissão | Atribua as funções de identidade necessárias para que ele possa acessar o serviço de destino. | Usuário | Conector do Serviço |
Próximas etapas
Saiba como integrar diferentes serviços de destino e leia sobre suas definições de configuração e métodos de autenticação.