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 pretende ajudá-lo a compreender:
- A relação entre o Service Connector e as associações de funções.
- 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
Associaçõ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 ter que trabalhar com SDKs de cliente em códigos de função.
A vinculação pode suportar entradas, saídas e gatilhos. As ligações permitem configurar a conexão com serviços para que o host do Functions possa lidar com o acesso aos dados para você. Para obter mais informações, veja Conceitos de acionadores e enlaces das Funções do Azure.
A vinculação de função suporta os tipos de autenticação secreta/cadeia de conexão e 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 abstrato, 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, delete, validate integridade e list configurations.
O Service Connector também suporta os tipos de autenticação secreta/cadeia de conexão e baseada em identidade.
Conexão em uma associação do Azure Functions
Em Ligações de funções, connection é uma propriedade definida em um arquivo de vinculação (geralmente o function.json arquivo) em sua pasta de função. Ele define o nome ou prefixo das configurações do aplicativo que será usado pelo tempo de execução da vinculação para autenticar nos serviços de destino.
Conexão no conector de serviço
Um connection no Service Connector refere-se a um recurso específico do Azure que pertence ao Service Connector.
O connection usado pelas associações do Azure Functions corresponde ao configuration name usado pelo Service Connector. O nome da configuração refere-se aos nomes das chaves 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 configurações de recursos na nuvem, como configurações de aplicativos, rede, identidade e atribuição de permissão, para que os usuários possam se concentrar em lógicas de negócios funcionais. As seções a seguir descrevem como o Service Connector ajuda a simplificar conexões de função com diferentes mecanismos de conexão e métodos de autenticação.
Enlace
- Segredo/cadeia de conexão
| Scenario | Operation | Description | Sem conector de serviço | Com conector de serviço |
|---|---|---|---|---|
| Projeto local | Adicionar vinculação | Adicione uma ligação em uma função de acordo com o tipo de serviço de destino e o tipo de vinculação (entrada/saída/gatilho). | User | User |
| Consumir encadernaçã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. |
User | User | |
| Recurso na nuvem | Configurar as definições da aplicação | Configure a cadeia de conexão como uma configuração de aplicativo nas configurações do recurso de função. | User | Conector do Serviço |
| Configurar rede | Verifique se a configuração de rede do serviço de destino permite o acesso a partir do recurso de função. | User | Conector do Serviço |
- Autenticação baseada em identidade
| Scenario | Operation | Description | Sem conector de serviço | Com conector de serviço |
|---|---|---|---|---|
| Projeto local | Adicionar vinculação | Adicione uma ligação em uma função de acordo com o tipo de serviço de destino e o tipo de vinculação (entrada/saída/gatilho). | User | User |
| Consumir encadernaçã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. |
User | User | |
| Recurso na nuvem | Configurar as definições da aplicação | Configure as configurações de identidade da Função do Azure, como pontos de extremidade de serviço. | User | Conector do Serviço |
| Configurar rede | Certifique-se de que a configuração de rede do serviço de destino permite o acesso a partir do recurso de função. | User | Conector do Serviço | |
| Configurar identidade | Verifique se a identidade do sistema está habilitada ao usar a identidade do sistema para autenticar. | User | 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. | User | Conector do Serviço |
Ao usar o Service Connector com ligações de função, preste especial atenção ao nome da chave da função configurada pelo Service Connector. Certifique-se de que é o mesmo nome de chave que o definido na connection propriedade no arquivo de vinculação. Se for diferente, altere o nome no arquivo de vinculação ou use o recurso do Service Connector para personalizar os nomes de configuração padrão do customize keys Service Connector.
SDK
- Segredo/cadeia de conexão
| Scenario | Operation | Description | 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. | User | User |
| Iniciar cliente SDK | Defina a cadeia de conexão para autenticação em local.settings.json. Inicie o SDK do serviço de destino usando uma cadeia de conexão. |
User | User | |
| Recurso na nuvem | Configurar as definições da aplicação | Configure uma cadeia de conexão como uma configuração de aplicativo na configuração da função. | User | Conector do Serviço |
| Configurar rede | Verifique se a configuração de rede do serviço de destino permite o acesso a partir do recurso de função. | User | Conector do Serviço |
- Autenticação baseada em identidade
| Scenario | Operation | Description | 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. | User | User |
| Iniciar cliente SDK | Defina a cadeia de conexão para autenticação em local.settings.json. Inicie o SDK do serviço de destino usando uma cadeia de conexão. |
User | User | |
| Recurso na nuvem | Configurar as definições da aplicação | Configure uma cadeia de conexão como uma configuração de aplicativo na configuração da função. | User | Conector do Serviço |
| Configurar rede | Certifique-se de que a configuração de rede do serviço de destino permite o acesso a partir do recurso de função. | User | Conector do Serviço | |
| Configurar identidade | Verifique se a identidade do sistema está habilitada ao usar a identidade do sistema para autenticar. | User | 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. | User | Conector do Serviço |
Próximos passos
Saiba como integrar diferentes serviços de destino e leia sobre suas definições de configuração e métodos de autenticação.