Configurar o spoke do Microsoft Teams Communications

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura
  • Integre a instância [ ServiceNow e a conta Microsoft Teams comunicações criando uma aplicação OAuth personalizada em Microsoft Teams comunicações para autenticar solicitações ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o spoke do Microsoft Teams Communications.
    • Função necessária: administrador

    Registrar uma aplicação personalizada usando o Microsoft portal do Azure

    Forneça autorização para a instância ServiceNow registrando uma aplicação personalizada com Azure AD.

    Antes de Iniciar

    Função necessária: administrador do Azure Active Directory.

    Procedimento

    1. Faça login no Microsoft Portal do Azure.
    2. Em Serviços do Azure, clique em Registros de app.
      Registrar um app.
    3. Em Registros do app, clique em Novo registro.
      Novo registro de app.
    4. Forneça um nome e clique em Registrar .
      Registrando um app.
      A aplicação está registrada e os detalhes essenciais da aplicação são exibidos.
    5. Copie e registre o valor do ID da aplicação (cliente) e do ID do diretório (locatário) para uso posterior.
    6. Clique em Certificados e segredose em Novo segredo do cliente.
    7. No formulário, forneça Descrição e clique em Adicionar.
      Adicionar um segredo do cliente.
    8. Copia o valor do segredo do cliente para uso posterior.
      Copie o segredo do cliente.
    9. Clique em Permissões de API.
    10. Em Permissões configuradas, clique em Adicionar uma permissão.
    11. Em Solicitar permissões de API, selecione Microsoft Graph
      Adicione permissões.
    12. Clique em Permissões da aplicação.
    13. Certifique-se de que essas permissões sejam fornecidas para seu app personalizado:
      • User.Read.All
      • OnlineMeetings.ReadWrite
      • Chamadas.IniciarChamadaGrupo.Todos
      • Chamadas.IngressarNoGrupoChamada.Todos
      • Chamadas.IngressarNoGrupoChamadaComoConvidado.Todos
      Para obter mais informações sobre as permissões de API, consulte Como adicionar permissões para acessar sua API da Web no Microsoft Learning.
    14. Clique em Adicionar permissões.
      Adicione permissões da aplicação.
    15. Clique em Conceder consentimento ao administrador para MSFT.
      Conceder consentimento ao administrador.
      O sistema solicita que você confirme o consentimento.
    16. Clique em Sim.
      É exibida uma mensagem de confirmação de que o consentimento do administrador foi concedido para as permissões solicitadas.
      Mensagem de confirmação.
    17. Crie um bot e configure-o de acordo com seus requisitos.
      Para obter informações sobre como criar e configurar o bot, consulte Criar um bot no Microsoft Aprenda. Atualize o endereço do endpoint do bot para apontar para o seu bot.

    Registrar Microsoft Teams comunicações como um provedor OAuth

    Use as informações geradas durante a configuração da aplicação no portal do Azure Microsoft para registrar Microsoft Teams comunicações como o provedor OAuth para que a instância ServiceNow possa solicitar tokens OAuth 2.0.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
      O sistema exibe esta mensagem: Que tipo de aplicação OAuth?.
    3. Selecione Conectar-se a um provedor OAuth de terceiros.
    4. No formulário, preencha estes valores.
      Tabela 1. Formulário de registros de aplicações
      Campo Descrição
      ID de cliente ID da aplicação criado durante o registro da aplicação.
      Segredo do cliente Segredo do cliente criado durante o registro do aplicativo.
      Ativo Opção para usar ativamente o registro da aplicação.
      URL de Autorização Endpoint do código de autorização do OAuth. Insira https://login.microsoftonline.com/<Directory-ID> /oauth2/v2.0/authorize .
      URL de Token Endpoint do token do servidor OAuth. Insira https://login.microsoftonline.com/<Directory-ID> /oauth2/v2.0/token .
      URL de revogação do token Endpoint de revogação de token do servidor OAuth.
      Redirecional URL Endpoint de retorno de chamada do OAuth. Insira https://<instance-name> .service-now.com/oauth_redirect.do .
      Tipo de concessão padrão Tipo de concessão usado para estabelecer o token. Selecione Credenciais do Cliente.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    6. Na guia Perfis de entidade OAuth, insira uma linha e preencha estes valores:
      Campo Descrição
      Nome Nome para identificar o registro de perfil da entidade. Por exemplo, MS Teams Comm OAuth Prof.
      É padrão Especifica se o registro é o perfil de entidade padrão.
      Tipo de concessão Tipo de concessão usado para estabelecer o token. Selecione Credenciais do Cliente.
    7. Na guia Escopos de Entidade OAuth, insira uma linha e preencha estes valores:
      Campo Descrição
      Nome Nome para identificar o registro do escopo da entidade. Por exemplo, Escopo OAuth de comunicação do MS Teams.
      Escopo de OAuth Escopo da entidade OAuth. Insira .default.
    8. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    9. Na guia Perfis de entidade OAuth, abra o registro de perfil de entidade que você criou.
    10. Na guia Escopos de Entidade OAuth, insira um registro.
    11. Pesquise e selecione o escopo da entidade OAuth que você criou.
    12. Clique em Atualizar.

    Criar um registro de credencial para o Microsoft Teams comunicações

    Autorize as ações de spoke Microsoft Teams comunicações criando registros de credenciais para a aplicação registrada no portal do Azure Microsoft. O alias de conexão e credencial Microsoft Teams comunicações usa essas credenciais para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexões e credenciais.
    2. Abra o registro de alias, MSTeamsCommunicationsSpoke.
    3. Na guia Credenciais, clique em Novo.

      O sistema exibe a mensagem: Que tipo de Credenciais você deseja criar?

    4. Selecione Credenciais OAuth 2.0.
    5. No formulário, preencha os campos.
      Tabela 2. Formulário de credenciais OAuth 2.0
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, MS Teams Comm Cred.
      Ativo Opção de usar ativamente o registro de credencial.
      Perfil de Entidade OAuth Perfil OAuth criado durante o registro de Microsoft Teams comunicações como um provedor OAuth. Por exemplo, MS Teams Comm OAuth Prof.
    6. Clique com o botão direito no cabeçalho do formulário e clique em Enviar.
    7. Para gerar o token OAuth, clique no link relacionado Obter Token OAuth.