Configurar spoke Google Drive

  • Versão de lançamento: Washingtondc
  • Atualizado 3 de ago. de 2023
  • 5 min. de leitura

    • Integre uma instância [ ServiceNow e Spoke do Google Drive usando as credenciais do Google Drive para autenticar ServiceNow solicitações.

    Antes de Iniciar

    • Solicitar assinatura do IntegrationHub.
    • Ative o Spoke do Google Drive.
    • Função necessária: administrador

    Configurar a aplicação Google Drive

    Crie uma aplicação OAuth personalizada da sua conta Google Drive para habilitar a autenticação OAuth 2.0 com o Spoke do Google Drive.

    Antes de Iniciar

    Google Drive requisitos de integração:
    • Um domínio e um endereço de e-mail associados ao domínio. Por exemplo, www.mydomain.com e jane-admin@mydomain.com. Você só pode registrar um endereço de e-mail por domínio em G Suite ou Google Drive.
    • Um login Google G Suite ou Google Drive criado com o domínio.
    • Uma conta Google Drive.

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Conclua essas etapas na sua conta Google G Suite ou Google Drive. Consulte a documentação do produto G Suite para obter instruções sobre como criar e configurar aplicações personalizadas.

    Procedimento

    1. Faça login no portal G Suite, https://gsuite.google.com/, com suas credenciais de e-mail de domínio.
    2. Insira o nome da sua empresa, o número de funcionários e seu país e selecione Avançar.
    3. Insira o nome de contato do administrador, o endereço de e-mail e o número do telefone comercial e selecione Avançar.
    4. Insira o domínio associado a este spoke.
    5. Forneça o nome de usuário e a senha do seu domínio.
    6. Adicione usuários à conta G Suite.
    7. Verifique seu domínio e endereço de e-mail.
      Os usuários devem criar seus próprios logins navegando até a documentação Google.
    8. Registrar uma nova aplicação personalizada.
      1. Navegue até https://console.developers.google.com.
      2. Crie um projeto com suas credenciais de administrador G Suite.
    9. Pesquise a API Google Drive e habilite-a.
    10. Crie uma aplicação de credenciais e salve o ID do cliente e o segredo do cliente.
      O segredo do cliente só é exibido em texto sem formatação por um curto período de tempo. Copie o ID do cliente e o Segredo do cliente para um arquivo de texto para que você possa usá-los ao Registrar Google Drive como um provedor OAuth.

    Registrar Google Drive como um provedor OAuth

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

    Antes de Iniciar

    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, GoogleDrive.
      ID de cliente Insira o ID de cliente da aplicação Google Drive que você criou no G Suite.
      Segredo do cliente Insira o segredo do cliente que você gerou ao criar a aplicação no G Suite.
      Script do API da OAuth Clique no ícone de pesquisa (ícone de pesquisa) e selecione OAuthUtilGoogleDrive.
      Tipo de concessão padrão Selecione Código de autorização.
      URL de Autorização Clique no ícone de cadeado Ícone de cadeado, insira https://accounts.google.com/o/oauth2/authe clique no ícone de cadeado novamente.
      URL do token Clique no ícone de cadeado Ícone de cadeado, insira https://www.googleapis.com/oauth2/v4/tokene clique no ícone de cadeado novamente.
      URL de redirecionamento Clique no ícone de cadeado Ícone de cadeado, insira https://<instance> .service-now.com/oauth_redirect.do e clique no ícone de cadeado novamente.
    5. Opcional: Na lista relacionada Escopos de entidade OAuth, adicione todos os escopos necessários para sua aplicação.

      O Spoke do Google Drive inclui os seguintes escopos por padrão:

      • dados da aplicação
      • unidade
      • drivereadonly
      • arquivo
      • transferência de arquivo
      • metadados
      • metadadosreadonly
      • fotossomente leitura
      • scripts
      • usuário

      Clique em Inserir uma nova linha e insira o nome e o escopo OAuth da permissão. O nome e o escopo do OAuth geralmente são a mesma cadeia de caracteres.Uma seleção de escopos de entidade OAuth

    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 registro de credencial para o spoke Google Drive

    Crie registros de Credencial para conectar a aplicação OAuth personalizada Google Drive que você criou durante a configuração da conta Google Drive. Os aliases de conexão e credencial Spoke do Google Drive usam essas credenciais para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > IntegrationHub > Conexões e Credenciais > Credenciais e clique em Novo.
    2. Selecione Credenciais OAuth 2.0.
    3. Insira um nome exclusivo para a credencial, por exemplo, Cred do gDrive.
    4. Clique no ícone de pesquisa Perfil de entidade OAuth ( ícone Pesquisar) e selecione o perfil com o nome do registro da aplicação OAuth que você criou ao registrar o serviço Google Drive como um provedor OAuth.
    5. Clique em Obter token Oauth.

    Criar registro de conexão para o Google Drive

    Crie registros de conexão para uma conta Google Drive. Um alias de conexão resolve sua conexão e credencial Google Drive no tempo de execução. Somente uma conexão está ativa por alias de conexão de cada vez.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Selecione a conexão do Google Drive.
    3. Na lista relacionada Atributos de conexão, defina o valor padrão da versão da API como v3.
      Se não houver atributos de conexão, clique em Novo e crie um atributo de conexão com estas informações:
      Campo Valor necessário
      Rótulo Versão da API
      Nome da coluna u_api_version
      Obrigatório Falso
      Somente leitura Falso
      Tipo Cadeia de caracteres
      Referência (vazia)
      Valor-padrão v3
    4. Na lista relacionada Conexões, selecione Conexão do gDrive.
      Campo Valor necessário
      Nome Insira o nome Conexão do gDrive.
      Credencial Selecione o nome da credencial que você especificou ao criar o registro de credencial. O valor usado nas etapas acima é gDrive Cred.
      Alias de conexão Selecione o valor sn_googledrive_spoke.Google_Drive
      URL de conexão Insira o URL https://www.googleapis.com/.
      Tipo de concessão padrão Selecione Credenciais do cliente.
      URL de Autorização Insira https://accounts.google.com/o/oauth2/auth.
    5. Retornar a IntegrationHub > Conexões e Credenciais > Credenciais e selecione googledrive_cred.
    6. Em Links relacionados, clique em Obter token OAuth.
      Uma mensagem de confirmação indica que o fluxo de token OAuth foi concluído com sucesso. Revise os detalhes se o fluxo não for bem-sucedido.
      Nota:
      Certifique-se de permitir janelas pop-up no navegador.

    Resultado

    O Spoke do Google Drive está configurado e integrado à instância ServiceNow.