Configurar Microsoft Spoke do OneDrive

Integrar o. ServiceNow instância e. Microsoft Spoke do OneDrive Usando credenciais OAuth 2,0 para autenticar ServiceNow solicitações.

Antes de Iniciar

• Solicitar uma assinatura de IntegrationHub.
• Ative o. Microsoft Spoke do OneDrive .
• Função necessária: administrador

Configurar Microsoft OneDriveaplicação

Crie uma aplicação OAuth personalizada do seu Microsoft OneDriveConta para habilitar a autenticação OAuth 2,0 com Spoke do Microsoft OneDrive.

Antes de Iniciar

Requisitos Microsoft OneDrive:

• Microsoft OneDrive conta
• Conta Microsoft Azure
• Função necessária: Microsoft OneDrivecredenciais de administrador do locatário

Por Que e Quando Desempenhar Esta Tarefa

Conclua estas etapas na sua conta de desenvolvedor do Azure. Consulte a documentação do produto Azure para obter instruções sobre como criar e configurar aplicações personalizadas.

Procedimento

1. Faça login no Portal de registro do aplicativo Microsoft Azure com as credenciais da sua organização.
2. Registrar uma nova aplicação personalizada.
   Preencha o nome da aplicação, o tipo de conta compatível e o URI de redirecionamento e clique em Registre-se .
   Uma visão geral das informações básicas da aplicação é mostrada.

   Nota:

   Insira o URI de redirecionamento neste formato: https://<instance>.service-now.com/oauth_redirect.do .
3. Copie o ID da aplicação para um arquivo de texto.
   Você usará este ID e o segredo do cliente gerado na próxima etapa para registrar o app como um provedor OAuth de terceiros em sua instância ServiceNow. Você usa o ID da aplicação como o ID do cliente ao conectar a aplicação ao ServiceNow.
4. Adicionar um segredo do cliente.
   1. No Microsoft Azure, navegue até Gerenciar > Certificados e segredos.
   2. Forneça uma descrição e uma data de expiração e clique em Adicionar .
      Nota:

      O segredo do cliente só é exibido em texto sem formatação por um curto período de tempo. Você usa o segredo do cliente ao conectar a aplicação ao ServiceNow.
5. Habilite as permissões para as quais você deseja que a aplicação ofereça suporte.
   Para obter mais informações, consulte Referência de permissões do Microsoft Graph .
   1. No Microsoft Azure, navegue até Gerenciar > Permissões de API.
   2. Clique no bloco do Microsoft Graph.
   3. Selecione as permissões delegadas ou da aplicação compatíveis com a aplicação.
      As permissões delegadas permitem que a aplicação acesse a API como um usuário conectado. As permissões da aplicação permitem que a aplicação seja executada como um serviço ou daemon em segundo plano sem um usuário conectado. Você Deve mencionar essas permissões de API no Escopos da entidade OAuth ao configurar o. registro da aplicação .

      Nota:

      Você deve garantir que essas permissões de API sejam fornecidas para seu app personalizado.

      Nome	Escopo do OAuth
      Calendars.ReadWrite	Calendars.ReadWrite
      Calendars.ReadWrite.Shared	Calendars.ReadWrite.Shared
      e-mail	e-mail
      Files.Read	Files.Read
      Files.Read.All	Files.Read.All
      offline_access	offline_access

   4. Clique em Adicionar permissões .

Registre-se Microsoft OneDriveComo provedor OAuth

Use as informações geradas durante a configuração da conta Microsoft OneDrive para registrar o Microsoft OneDrive como um provedor do OAuth e permitir que a instância solicite tokens do OAuth 2.0.

Antes de Iniciar

• Solicitar assinatura do IntegrationHub.
• Ativar Spoke do Microsoft OneDrive.
• Criar Microsoft OneDriveaplicação.
• Se você estiver usando um único registro de aplicativo de locatário, obtenha o valor de ID do diretório (locatário) No portal do Azure.

Função necessária: administrador

Procedimento

1. Na ServiceNow, navegue até OAuth de Sistema > Registro de aplicações.
2. Clique em Nova.
3. Na tela intitulada Que tipo de aplicação OAuth, selecione Conectar a um provedor OAuth de terceiros.
4. Insira estes valores no formulário Registros da aplicação:

   Campo	Valor necessário
   Nome	Insira qualquer nome para identificar exclusivamente o registro, por exemplo Perfil OAuth do OneDrive .
   ID de cliente	Insira o ID da aplicação do OneDrive que você criou no Azure.
   Segredo do cliente	Insira o Segredo do cliente gerado ao criar a aplicação no Azure.
   Tipo de concessão padrão	Selecione Código de autorização.
   URL de Autorização	Se você estiver usando um registro de aplicativo multilocatário, clique no ícone de cadeado insira https://login.microsoftonline.com/common/oauth2/v2.0/authorize e clique no ícone de cadeado novamente. Se você estiver usando um único registro de aplicativo de locatário, clique no ícone de cadeado insira https://login.microsoftonline.com/<Directory-ID>/oAuth2/v2.0/Authorize e clique no ícone de cadeado novamente. No URL, substitua <Directory-ID> com o valor de ID do diretório (locatário) Obtido no portal do Azure.
   URL do token	Clique no ícone de cadeado insira https://login.microsoftonline.com/common/oauth2/v2.0/token e clique no ícone de cadeado novamente.
   Redirecional URL	Clique no ícone de cadeado insira https://<instance>.service-now.com/oauth_redirect.do e clique no ícone de cadeado novamente.

5. Em Escopos da entidade OAuth lista relacionada, adicione escopos para corresponder às permissões que você definiu quando configurou o. Microsoft OneDriveaplicação.
   Clique em Insira uma nova linha E insira o nome e o escopo OAuth da permissão. O nome e OAuth o escopo geralmente é a mesma cadeia de caracteres. Certifique-se de que esses escopos sejam fornecidos.

   Nome	Escopo do OAuth
   Calendars.ReadWrite	Calendars.ReadWrite
   Calendars.ReadWrite.Shared	Calendars.ReadWrite.Shared
   e-mail	e-mail
   Files.Read	Files.Read
   Files.Read.All	Files.Read.All
   offline_access	offline_access

   Nota:

   Os escopos mencionados aqui devem ser iguais às permissões de API fornecidas durante configuração do app personalizada .
6. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
   O sistema valida as credenciais do OAuth.

Criar alias de conexão e credencial para Microsoft OneDrivespoke

Crie registros de conexão para seu Microsoft OneDriveconta. . Microsoft OneDriveos aliases de conexão e credencial do spoke usam essas conexões para executar ações no Microsoft OneDrive.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > IntegrationHub > Conexões e Credenciais > OneDrive.
2. De Links relacionados clique em Criar nova conexão e credencial .
3. No formulário, preencha os seguintes campos:

   Campo	Valor necessário
   Nome da Conexão	Nome para identificar a conexão. Este campo é definido automaticamente como Conexão do Microsoft OneDrive Spoke
   URL de conexão	A URL para fazer conexão com o spoke. Este campo é definido automaticamente como https://graph.microsoft.com
   Nome da entidade OAuth	Nome do perfil da entidade OAuth. Este campo é definido automaticamente como Autenticação de spoke do Microsoft OneDrive.
   ID do cliente do OAuth	ID do cliente da aplicação OneDrive que você registrou no portal de registro do aplicativo Microsoft Azure.
   Segredo do cliente do OAuth	Segredo do cliente gerado quando você registrou a aplicação no portal do Microsoft Azure.
   URL de redirecionamento do OAuth	O URL de redirecionamento. O formato da URL é https://<your-instance>.service-now.com/oauth_redirect.do

4. Clique em Criar e obter token OAuth.

Resultado

. Microsoft Spoke do OneDrive está configurado e integrado ao ServiceNow instância.