Criar registros de provedor OAuth de terceiros

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 min. de leitura

    • Crie registros de provedor OAuth de terceiros para permitir que cada uma de suas instâncias acesse os endpoints da API que você criou.

    Antes de Iniciar

    Conclua as tarefas em Criar endpoints da API da OAuth para clientes externos.

    No canto superior direito da instância, defina o escopo da aplicação como Global.

    Abra todas as suas instâncias (desenvolvimento, teste, produção e assim por diante) em guias separadas do navegador. Comece as etapas abaixo na instância de produção.

    Função necessária: administrador

    Procedimento

    1. Em sua instância de produção, navegue até Todos > OAuth de Sistema > Registro de aplicações.
      Você deve criar três registros aqui, um para cada uma das três instâncias (desenvolvimento, teste e produção). Se você tiver instâncias adicionais de não produção (preparação e assim por diante), crie um registro para cada uma delas seguindo o método mostrado aqui.

    2. Selecione Novo.
    3. Selecione Conectar a um provedor OAuth de terceiros para criar um registro para sua instância de desenvolvimento.
    4. No formulário, preencha os campos.
      Tabela 1. Formulário de registros de aplicações
      Campo Ação
      Nome Insira Conexão de instância de dispositivo.
      ID de cliente
      1. Em sua instância de desenvolvimento, abra a lista de Registro de aplicações (Todos > OAuth de Sistema > Registro de aplicações).
      2. Abra o registro do cliente de desenvolvimento de pipeline.
      3. Copie o ID do cliente.
      4. Em sua instância de produção, cole o ID do cliente da sua instância de desenvolvimento no campo ID do cliente.
      Segredo do Cliente
      1. Em sua instância de desenvolvimento, abra a lista de Registro de aplicações (Todos > OAuth de Sistema > Registro de aplicações).
      2. Abra o registro do cliente de desenvolvimento de pipeline.
      3. Desbloqueie o campo Segredo do cliente e copie o texto.
      4. Em sua instância de produção, cole o Segredo do cliente da sua instância de desenvolvimento no campo Segredo do cliente.
      Tipo de concessão padrão Mude para Código de autorização.
      URL de Autorização
      1. Desbloqueie o campo.
      2. Insira o URL da sua instância de desenvolvimento seguido por oauth_auth.do.
      3. Bloqueie o campo.
      Por exemplo: https://<development instance name> .service-now.com/oauth_auth.do .
      URL de Token
      1. Desbloqueie o campo.
      2. Insira o URL da sua instância de desenvolvimento seguido por oauth_token.do.
      3. Bloqueie o campo.
      Por exemplo: https://<development instance name> .service-now.com/oauth_token.do .
    5. Selecione Enviar.
    6. Selecione Novo.
    7. Selecione Conectar a um provedor OAuth de terceiros para criar um registro para sua instância de teste.
    8. No formulário, preencha os campos.
      Tabela 2. Formulário de registros de aplicações
      Campo Ação
      Nome Insira Testar conexão da instância.
      ID de cliente
      1. Em sua instância de teste, abra a lista de Registro de aplicações (Todos > OAuth de Sistema > Registro de aplicações).
      2. Abra o registro Cliente de teste de pipeline.
      3. Copie o ID do cliente.
      4. Em sua instância de produção, cole o ID do cliente da sua instância de teste no campo ID do cliente.
      Segredo do Cliente
      1. Em sua instância de teste, abra a lista de Registro de aplicações (Todos > OAuth de Sistema > Registro de aplicações).
      2. Abra o registro Cliente de teste de pipeline.
      3. Desbloqueie o campo Segredo do cliente e copie o texto.
      4. Em sua instância de produção, cole o Segredo do cliente da sua instância de teste no campo Segredo do cliente.
      Tipo de concessão padrão Mude para Código de autorização.
      URL de Autorização
      1. Desbloqueie o campo.
      2. Insira o URL da sua instância de teste seguido por oauth_auth.do.
      3. Bloqueie o campo.
      Por exemplo: https://<test instance name> .service-now.com/oauth_auth.do .
      URL de Token
      1. Desbloqueie o campo.
      2. Insira o URL da sua instância de teste seguido por oauth_token.do.
      3. Bloqueie o campo.
      Por exemplo: https://<test instance name> .service-now.com/oauth_token.do .
    9. Selecione Enviar.
    10. Na lista Registro da aplicação, selecione o registro do cliente do controlador de pipeline.
    11. Copie o ID do cliente e cole-o em algum lugar, como uma aplicação de anotações.
    12. Desbloqueie o campo Segredo do cliente, copie o texto e cole-o em uma anotação com o ID do cliente.
    13. Volte para a lista Registro de aplicações e selecione Novo.
    14. Selecione Conectar a um provedor OAuth de terceiros para criar um registro para sua instância de produção.
    15. No formulário, preencha os campos.
      Tabela 3. Formulário de registros de aplicações
      Campo Ação
      Nome Insira a conexão da instância de produção.
      ID de cliente
      1. Copie o ID do cliente que você anotou.
      2. Cole o ID do cliente no campo ID do cliente.
      Segredo do Cliente
      1. Copie o segredo do cliente que você anotou.
      2. Desbloqueie o campo Segredo do cliente e cole o texto no campo.
      Tipo de concessão padrão Mude para Código de autorização.
      URL de Autorização
      1. Desbloqueie o campo.
      2. Insira o URL da sua instância de produção seguido por oauth_auth.do.
      3. Bloqueie o campo.
      Por exemplo: https://<production instance name> .service-now.com/oauth_auth.do .
      URL de Token
      1. Desbloqueie o campo.
      2. Insira o URL da sua instância de produção seguido por oauth_token.do.
      3. Bloqueie o campo.
      Por exemplo: https://<production instance name> .service-now.com/oauth_token.do .
    16. Selecione Enviar.
      Importante:
      Conclua as próximas etapas na sua instância de desenvolvimento.
    17. Em sua instância de desenvolvimento, navegue até Todos > OAuth de Sistema > Registro de aplicações.

    18. Selecione Novo.
    19. Selecione Conectar a um provedor OAuth de terceiros para criar um registro para sua instância de produção.
    20. No formulário, preencha os campos.
      Tabela 4. Formulário de registros de aplicações
      Campo Ação
      Nome Insira a conexão da instância de produção.
      ID de cliente
      1. Copie o ID do cliente que você anotou.
      2. Cole o ID do cliente no campo ID do cliente.
      Segredo do Cliente
      1. Copie o segredo do cliente que você anotou.
      2. Desbloqueie o campo Segredo do cliente e cole o texto no campo.
      Tipo de concessão padrão Mude para Código de autorização.
      URL de Autorização
      1. Desbloqueie o campo.
      2. Insira o URL da sua instância de produção seguido por oauth_auth.do.
      3. Bloqueie o campo.
      Por exemplo: https://<production instance name> .service-now.com/oauth_auth.do .
      URL de Token
      1. Desbloqueie o campo.
      2. Insira o URL da sua instância de produção seguido por oauth_token.do.
      3. Bloqueie o campo.
      Por exemplo: https://<production instance name> .service-now.com/oauth_token.do .
    21. Selecione Enviar.
      Importante:
      Conclua as próximas etapas na sua instância de teste.
    22. Em sua instância de teste, navegue até Todos > OAuth de Sistema > Registro de aplicações.
    23. Selecione Novo.
    24. Selecione Conectar a um provedor OAuth de terceiros para criar um registro para sua instância de produção.
    25. No formulário, preencha os campos.
      Tabela 5. Formulário de registros de aplicações
      Campo Ação
      Nome Insira a conexão da instância de produção.
      ID de cliente
      1. Copie o ID do cliente que você anotou.
      2. Cole o ID do cliente no campo ID do cliente.
      Segredo do Cliente
      1. Copie o segredo do cliente que você anotou.
      2. Desbloqueie o campo Segredo do cliente e cole o texto no campo.
      Tipo de concessão padrão Mude para Código de autorização.
      URL de Autorização
      1. Desbloqueie o campo.
      2. Insira a URL da sua instância de produção, seguida de oauth_auth.do
      3. Bloqueie o campo.
      Por exemplo: https://<production instance name> .service-now.com/oauth_auth.do .
      URL de Token
      1. Desbloqueie o campo.
      2. Insira a URL da sua instância de produção, seguida de oauth_token.do
      3. Bloqueie o campo.
      Por exemplo: https://<production instance name> .service-now.com/oauth_token.do .
    26. Selecione Enviar.
    27. Opcional: Repita as etapas 22 a 26 para todas as outras instâncias que não sejam de produção que você tenha (preparação e assim por diante).

    O que Fazer Depois

    Agora que você concluiu o pré-trabalho para usar o OAuth, conclua todas as etapas em Usar OAuth para criar credenciais de pipeline nas instâncias especificadas.