Skip to main content
Documentatie
Documentatie
Administrator Guide
Laatst bijgewerkt: 2023-06-23
Verifiëren bij agentgateway

Verifiëren bij agentgateway

  • Registreer uw agent bij Agent System of Record (ASOR) via de nieuwe
    agentregistratie-
     API. Zie Uw agent registreren en definiëren via een API voor meer informatie over het registreren van uw agent bij ASOR.
  • Client-ID: deze verkrijgt u via de configuratie in ASOR.
  • Clientgeheim: u verkrijgt dit via de configuratie in ASOR.
  • Autorisatie-eindpunt: https://us.agent.workday.com/auth/authorize/<Tenant_Alias>
  • Token endpoint: https://us.agent.workday.com/auth/oauth2/<Tenant_Alias>/token
  • Omleidings-URI: de ontwikkelaar van de agent geeft deze in ASOR op tijdens de configuratiestap voor uw agent.
  • Uw agent is actief in ASOR.
De agentgateway kan alleen aanvragen naar het juiste Workday -datacenter routeren als de alias van uw tenant bekend is. Deze alias moet worden opgegeven bij alle API aanvragen van de agent, inclusief aanvragen voor verificatie. Uw tenant is meestal de naam van uw tenant en is te vinden in de URL van uw Workday alias : https://wd8.myworkday.com/stark-industries/d/home.htmld.
Als u alle relevante API aanroepen naar het toegewezen agentgateway-eindpunt wilt doorsturen, moet u de code van uw agent wijzigen of de configuratie '' wijzigen .
De volgende afbeelding illustreert een verificatie voor het verlenen van OAuth 2.0-autorisatiecodes. Dit zijn gedetailleerde stappen van de stroom zelf; Als uw externe agentplatform de OAuth 2.0-standaard ondersteunt , zou dit proces al moeten worden ondersteund.
OAuth 2.0-verificatie
De stappen beschrijven de standaard-OAuth 2.0-stroom, die u normaal gesproken niet handmatig hoeft te implementeren. Voor een standaard OAuth- client zijn alleen de configuratie vereist die zijn opgegeven in de sectie
'Vereisten'
 . Zie Externe agents configureren in Workday voor meer informatie over verificatie .
  1. Als u een autorisatiecode aanvraag , verzendt u een HTTPS GET- aanvraag naar het autorisatie-eindpunt in de agentgateway.
    Verzend deze aanvraag in uw browser en meld u aan als daarom wordt gevraagd: 
    https://us.agent.workday.com/auth/authorize/<Tenant Alias>?client_id=<OAuth_Client_ID>&response_type=code
    De agentgateway verzendt deze aanvraag naar de verificatiegateway in het datacenter waar uw tenant zich bevindt, met behulp van de tenantalias in de aanvraag. De verificatiegateway stuurt u vervolgens om naar een pop-upvenster voor aanmelding bij Workday om te verifiëren. Nadat de agent zich heeft aangemeld en toestemming heeft gegeven voor toegang tot Workday -gegevens, ontvangen uw agent een autorisatiecode.
  2. Kopieer de waarde van de autorisatiecode uit het antwoord ''.
  3. Als u een toegangstoken '' aanvraag , verzendt u een POST- aanvraag naar het token in de agentgateway.
    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>
    De agentgateway stuurt de aanvraag door naar de verificatiegateway in het datacenter van de tenant. Nadat de opgegeven referenties zijn gevalideerd, aanvraag de verificatiegateway het toegangstoken aan bij OMS. Uw agent ontvangen vervolgens het toegangstoken ''.