Registrar um bot no Azure

aplica-se a: SDK v4

Este artigo mostra como registrar um bot com o serviço de bot do Azure ao desenvolver e hospedá-lo no Azure.

Se o bot estiver hospedado em outro lugar, você também poderá disponibilizá-lo no Azure e conectá-lo aos canais com suporte. Você fornece o endereço da Web onde o bot está hospedado.

Importante

Você só precisa registrar um bot se ele não estiver hospedado no Azure. Os bots criados usando o portal do Azure ou a CLI (interface de linha de comando) já estão registrados com o serviço de bot do Azure. Para obter mais informações, consulte implantar seu bot.

Criar o recurso

Crie o recurso de bot do Azure , que permitirá que você registre seu bot com o serviço de bot do Azure.

Aviso

O registro dos canais de bot e bot do aplicativo Web será preterido, mas os recursos existentes continuarão a funcionar. Em vez disso, você deve usar o bot do Azure.

  1. Vá para o Portal do Azure.

  2. No painel direito, selecione criar um recurso.

  3. Na caixa de pesquisa, digite bot e pressione Enter.

  4. Selecione o cartão de bot do Azure .

    Selecionar recurso de bot do Azure

  5. Selecione Criar.

    Criar recurso de bot do Azure

  6. Insira os valores necessários. A figura a seguir mostra a criação da nova ID do aplicativo Microsoft selecionada.

    Criar valores de recurso de bot do Azure

    Você também pode selecionar usar registro de aplicativo existente e inserir sua ID de aplicativo e senha existentes.

    Criar valores existentes do recurso de bot do Azure

  7. Selecione Examinar + criar.

  8. Se a validação for aprovada, selecione criar.

  9. Selecione Ir para grupo de recursos. Você deve ver o bot e os recursos de Azure Key Vault relacionados listados no grupo de recursos selecionado.

    Dica

    O segredo do aplicativo (senha) é armazenado no cofre de chaves e há um cofre de chaves por grupo de recursos. O uso do Key Vault é recomendado em vez de copiar e armazenar dados confidenciais.

  10. Selecione obter o SDK do GitHub para criar o bot com o SDK do bot Framework.

    Criar bot no SDK

Cofre de Chave do Azure

Quando o Azure cria o recurso de bot do Azure, ele também gera uma ID de aplicativo e uma senha e armazena a senha em Azure Key Vault.

Key Vault é um serviço que fornece gerenciamento de segredos centralizado, com controle total sobre políticas de acesso e histórico de auditoria. Para obter mais informações, consulte usar referências de Key Vault para o serviço de aplicativo e Azure Functions. Observe que você será cobrado por uma pequena taxa para usar o serviço. Para saber mais, confira Preços do Key Vault.

ID e senha do aplicativo

Você precisa da ID e da senha do aplicativo de recurso de bot do Azure para configurar o bot para implantação. Você atribuirá seus valores às variáveis relacionadas: MicrosoftAppId e MicrosoftAppPassword contidas no arquivo de configuração do projeto de bot. O arquivo difere dependendo da linguagem de programação usada para criar o bot, conforme mostrado abaixo.

O appsettings.json arquivo contém estas configurações:

{
  "MicrosoftAppId": "<your app id>",
  "MicrosoftAppPassword": "<your password>"
}

Obter a ID do aplicativo de recurso de bot do Azure

  1. Vá para o Portal do Azure.
  2. Selecione o recurso de bot do Azure para obter sua ID do aplicativo.
  3. No painel esquerdo, na seção Configurações, selecione Configuração.
  4. Copie e salve o valor contido na caixa ID do Aplicativo da Microsoft.

Obter a senha do recurso de bot do Azure Azure Key Vault

Quando o Azure cria o recurso de Bot do Azure, ele armazena a senha do aplicativo Azure Key Vault. Para obter informações sobre como acessar o cofre de chaves para obter sua senha, consulte:

Registro manual do aplicativo

Um registro manual é necessário para situações como:

  • Você não consegue fazer os registros em sua organização e precisa de terceiros para criar a ID do aplicativo para o bot que você está criando.
  • Você precisa criar manualmente sua própria ID de aplicativo e senha.

Importante

Ao criar o aplicativo, na seção Dá suporte a tipos de conta, escolha uma das seguintes opções de tipos multi-locatário:

Tipo Descrição
Contas em qualquer diretório organizacional (Qualquer Azure AD – Multitenant) Essa opção fornece menos exposição restringindo o acesso e, caso o OAuth não tenha suporte.
Contas em qualquer diretório organizacional (Qualquer Azure AD – Multitenant) e contas pessoais da Microsoft (por exemplo, Xbox, Outlook.com) Essa opção é adequada para dar suporte à autenticação de bot e OAuth.

Para obter mais informações, confira Registrar um aplicativo na plataforma de identidade da Microsoft.

Atualizar o bot

Defina os seguintes valores de chave no appsettings.json arquivo:

  • MicrosoftAppId = <appId>
  • MicrosoftAppPassword = <appSecret>

Próximas etapas