Autenticando para o gateway do agente

Registre seu agente no Agent System of Record (ASOR) por meio da nova API
de registro de agente
. Para obter mais informações sobre como fazendo o registro seu agente no ASOR, consulte Registrar e definir seu agente por meio de uma API .

ID de cliente: essa ID é obtida na etapa de configuração no ASOR.

Chave secreta cliente: você a obtém na etapa de configuração no ASOR.

Authorization endpoint: https://us.agent.workday.com/auth/authorize/<Tenant_Alias>

Token endpoint: https://us.agent.workday.com/auth/oauth2/<Tenant_Alias>/token

URI de redirecionamento: o desenvolvedor do agente fornece isso no ASOR durante a etapa de configuração do seu agente.

Seu agente está ativo no ASOR.

Para que o gateway de agentes encaminhe solicitações para o data center do Workday correto, ele deve saber o alias de seu locatário. Este alias deve ser fornecido com todas as solicitações de API do agente, incluindo solicitações para autenticação. Normalmente, o alias de seu locatário é o nome do seu locatário , e pode ser encontrado no URL da sua instância do Workday : https://wd8.myworkday.com/stark-inthries/d/home.htmld.

Para direcionar todas as chamadas de API relevantes para o ponto de extremidade do gateway do agente atribuído, você deve modificar o código ou a configuração do agente .

A imagem a seguir ilustra um fluxo de autenticação padrão da concessão de código de autorização OAuth 2.0. Essas são etapas detalhadas do próprio fluxo; se sua plataforma de agente externo contribui para ao padrão OAuth 2.0, ela já deve oferecer suporte a esse processo.

As etapas descrevem o fluxo padrão do OAuth 2.0, que você não precisa implementar manualmente. Um cliente OAuth típico requer apenas os valores de configuração especificados na seção Pré-requisitos
. Para obter mais detalhes sobre a autenticação, consulte Configurar agentes externos no Workday .

Para solicitação um código de autorização, envie uma solicitação HTTPS GET para o ponto de extremidade de autorização no gateway do agente.

Envie esta solicitação pelo navegador e login; fazer login se for solicitada:

https://us.agent.workday.com/auth/authorize/<Tenant Alias>?client_id=<OAuth_Client_ID>&response_type=code

O gateway do agente enviará esta solicitação ao gateway de autenticação no data center em que seu locatário está localizado usando o alias do locatário na solicitação. O gateway de autenticação o redirecionará para uma janela pop-up de login no Workday para autenticação. Depois de um login bem-sucedido e do consentimento para que o agente acesse os dados do Workday , o agente receber um código de autorização.

Copie o valor do código de autorização da resposta.

Para solicitação um token de acesso, envie uma solicitação POST para o ponto de extremidade do token no gateway do agente.

POST  https://us.agent.workday.com/auth/oauth2/<Tenant_Alias>/token

grant_type=authorization_code
code=<authorization_code>
client_id=<OAuth_Client_ID>
client_secret=<OAuth_Client_Secret>

O gateway do agente encaminhará a solicitação para o gateway de autenticação no data center do locatário. Após a validação das credenciais especificadas, o Auth gateway solicitação o token de acesso do OMS. Seu agente receber o token de acesso.