Atualizar endpoints de REST e OAuth para Microsoft Office 365 planos governamentais

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • Altere os endpoints da mensagem REST e da aplicação OAuth em seu perfil de assinatura ServiceNow para que você possa usar suas assinaturas.

    Antes de Iniciar

    Função necessária: sam_admin

    Por Que e Quando Desempenhar Esta Tarefa

    O Now Platform® oferece suporte a Microsoft Office 365 planos de governança, que fornecem todos os recursos e capacidades dos serviços Microsoft 365 em uma comunidade de nuvem governamental segmentada que permite que as organizações atendam aos padrões de conformidade e segurança dos EUA.

    Para obter mais informações sobre Microsoft Office 365 planos de governança, consulte Office 365 Government.

    Procedimento

    1. Em sua instância ServiceNow, navegue até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
    2. Selecione o perfil de integração Microsoft 365 que você deseja atualizar.
    3. No registro do perfil de integração, selecione o ícone Visualizar este registro ( ícone Visualizar este registro.) ao lado do campo de mensagem REST.
    4. Na visualização do registro, selecione Abrir registro.
      O registro Mensagem de REST é aberto.
    5. Atualize os endpoints de mensagem REST no seu perfil de integração Microsoft 365.

      Os endpoints de mensagem REST permitem que você recupere dados de uso de suas Microsoft 365 aplicações e serviços.

      1. Na lista relacionada Métodos HTTP, atualize os endpoints de mensagem REST com base em suas necessidades.

        Microsoft fornece vários endpoints para Microsoft Office 365 planos governamentais. Para obter mais informações sobre os endpoints disponíveis, consulte Office 365 US Government GCC High endpoints.

        Importante:
        Você deve alterar o .com para .us no URL de cada endpoint. Por exemplo, você deve alterar https://graph.microsoft.com/v1.0/reports para https://graph.microsoft.us/v1.0/reports.
      2. Selecione Save (Salvar).
      3. Atualize o escopo da entidade OAuth para o endpoint GET de uso do PowerBI.
        O escopo da entidade OAuth especifica o nível de acesso que os usuários têm aos recursos protegidos.

        1. Selecione o endpoint GET PowerBI Usage.

          O registro Método HTTP é aberto.

        2. Na seção Autenticação do registro Método HTTP, selecione o ícone Visualizar este registro ( Ícone Visualizar este registro.) ao lado do campo de perfil OAuth.

        3. Na visualização do registro, selecione Abrir registro.

          O registro de perfil de entidade OAuth é aberto.

        4. Na lista Escopos de Perfil de Entidade OAuth, atualize o campo Escopo OAuth do escopo da entidade OAuth PowerBIPermissions com a URL da API de back-end que você está usando para Microsoft Power BI.
          Nota:
          Microsoft O é compatível com vários URLs de API de back-end para Power BI. Para obter mais informações sobre os URLs disponíveis, consulte Power BI for US Government.

        5. Selecione Atualizar.

          O registro de perfil de entidade OAuth é fechado e você retorna automaticamente ao registro de mensagem de REST.

    6. Atualize o endpoint da aplicação OAuth no seu perfil de integração Microsoft 365.
      O endpoint da aplicação OAuth permite que sua instância ServiceNow acesse seus dados de assinatura Microsoft 365.
      1. Na seção Autenticação do registro de Mensagem de REST, selecione o ícone Visualizar este registro ( Ícone Visualizar este registro.) ao lado do campo de perfil OAuth.
      2. Na visualização do registro, selecione Abrir registro.
        O registro de perfil de entidade OAuth é aberto.
      3. Na lista Escopos de Perfil de Entidade OAuth, altere o .com para .us no URL listado no campo Escopo do OAuth do escopo da entidade Permissões do OAuth.
      4. Selecione o ícone Visualizar este registro ( Ícone Visualizar este registro.) ao lado do campo do provedor OAuth.
      5. Na visualização do registro, selecione Abrir registro.
        O registro Registros de aplicações é aberto.
      6. Selecione o ícone Editar URL ( ícone Editar URL.) ao lado do campo URL do Token.
      7. No URL, altere .com para .us.
        Por exemplo, altere https://login.microsoftonline.com para https://login.microsoftonline.us.
      8. Selecione o ícone Bloquear URL ( Ícone Bloquear URL.).
      9. Selecione Atualizar.

    O que Fazer Depois

    Revalide os detalhes de conexão e credencial desta integração. Para obter mais informações, consulte Criação do perfil de Integração Microsoft 365.