Concetto: Considerazioni su ASU agente esterno

Le credenziali client dell'ASU fornite dopo la configurazione dell'agente devono essere utilizzate per il flusso di concessione del codice di autorizzazione OAuth 2.0 per consentire all'agente di ottenere l'accesso durante l'esecuzione dell'agente.

Quando si verifica manualmente il flusso sovvenzione del codice di autorizzazione di un agente esterno, utilizzare i dettagli client e gli URL degli endpoint forniti durante la configurazione dell'agente come input per i seguenti step:

Recuperare il codice di autorizzazione incollando questo URL in una nuova finestra:
https://<providedAuthorizeEndpoint>?response_type=code&client_id=<clientID>&state=<agentName>&redirect_uri=<redirectionURI>
.
L'URL reindirizza a una pagina di accesso in cui è necessario fornire manualmente le credenziali utente per cui l'agente agirà per conto di.
Dopo l'accesso, si viene reindirizzati a una pagina
Consenti/Rifiuta
in cui si sovvenzione all'agente l'accesso account Workday. Selezionare
Consenti
il reindirizzamento all'URI di reindirizzamento fornito con un codice aggiunto che è possibile utilizzare per chiamare l' API successiva .
Recuperare il token ASU creando una nuova richiesta utilizzando un client API esterno utilizzando il codice di autorizzazione fornito nella chiamata API precedente.
Esempio: Bruno:
POST https://<providedTokenURL>
Body:grant_type=authorization_code&code=<authorizationCode>&client_id=<clientID>&client_secret=<ClientSecret>
Vengono generati un token di accesso e un token aggiornare che è possibile utilizzare per testare le chiamate effettuate dall'agente ai servizi Workday .

Nel corpo della risposta dall'endpoint token , il parametro

applys_in

deve essere restituito come tipo Integer. In ambienti di test diversi, questo tipo di parametro può differire tra Integer e String, quindi è Workday che il client esterno sia in grado di gestire sia i tipi string che int.

Quando è necessario aggiornare una definizione agente, è possibile fornire lo stesso nome agente, versione e provider API POST AgentDefinition e questa verrà aggiornata. Se non esiste una corrispondenza, il Workday crea una nuova registrazione dell'agente.

Quando l'agente invia la richiesta all'endpoint token utilizzando AuthCode e le credenziali client , sia il token di accesso che i token aggiornare vengono creati e rinviati.

Il tempo di scadenza token di accesso è di 3600 secondi (60 min). La scadenza del token aggiornare è di 24 ore.

Quando un token di accesso scade, il token aggiornare ne crea uno nuovo.

I client OAuth tipici dovrebbero richiedere solo:

Segreto client
e
ID client
: ottenuti durante il processo configurazione dell'agente.
Autorizzazione endpoint
:
https://us.agent.workday.com/auth/authorize/ <Tenant Alias>
Token Endpoint
:
https://us.agent.workday.com/auth/oauth2/<Tenant_Alias>/token
URL di reindirizzamento
: fornito dallo sviluppatore dell'agente durante il processo configurazione dell'agente.

L'ID client ASU e il nome utente forniti dopo la configurazione dell'agente devono essere utilizzati per eseguire l'asserzione JWT e la generazione token .

L'autorità emittente deve essere l'ID cliente.
L'oggetto deve essere il nome utente dell'ASU.

La coppia di chiavi x509 corrispondente, obbligatorio durante la registrazione skill ambientali, viene utilizzata durante l'esecuzione dell'agente per eseguire l'asserzione JWT.

Aggiornare il codice dell'agente in modo che durante l'esecuzione dell'agente, quando una richiesta viene inoltrata all'agente, quest'ultimo verifichi se dispone di un token di accesso valido memorizzato nella cache. In caso contrario o se il token è scaduto:

Creare una nuova asserzione JWT
Recupera un token Bearer JWT
token cache per richieste API Workday