使用 OAuth 2.0 Bearer 權杖啟動整合

當您以編程方式啟動整合時，可以使用 OAuth 2.0 進行驗證。為此，您需要不記名存取權杖，此權杖是使用對權杖端點的 cURL 要求取得。

註冊 API 用戶端。執行此任務時，請參考以下資訊︰


用戶端授予類型	授權代碼授予
支援代碼交換驗證金鑰 (PKCE)	選取此核取方塊。
存取權杖類型	Bearer
重新導向 URI	範例︰https://google.com
授予行政同意	選取此核取方塊。
範圍	選取︰實作整合系統用戶不可配置

記下這些值以備日後使用︰

用戶端 ID

。範例︰

MjEwNGVmNTgtZWFkNS00MTQ2LWAAZjctNWYxMjBlNTEwMmIz

授權端點

範例︰

https://<hostname>
/super/authorize

權杖端點

。範例︰

https://<hostname>
/ccx/oauth2/super/token

使用 PKCE 代碼產生器網站產生 SHA-256 代碼驗證工具和代碼提示。記下這些值以備日後使用︰

代碼驗證者

。範例︰

Ii-HfGHYN01J0EZtToJwg9Wmuqss8mNF7_SE343tjMR7i_00HbsPA8sJAfMxlLksnfPsAtBo4SyOkYaYOvn1neUjcFM0oPtoFGQ2n7Uf43DXv2byDqWmd2JViccVbGuQ

代碼提示問題

。範例︰

x8SJ_t0WfmDB2JKvqwXAE8DxV7W_gP_jTDFVIBVvxYg

若要從瀏覽器取得授權代碼，請使用您先前取得的值建立 URL，格式如下︰

<Authorization Endpoint value>?client_id=<Client ID value>&response_type=code&code_challenge=<Code Challenge value>&code_challenge_method=S256

範例︰

https://<hostname>/super/authorize?client_id=MjEwNGVmNTgtZWFkNS00MTQ2LWAAZjctNWYxMjBlNTEwMmIz&response_type=code&code_challenge=x8SJ_t0WfmDB2JKvqwXAE8DxV7W_gP_jTDFVIBVvxYg&code_challenge_method=S256

在瀏覽器中輸入 URL，並核准您用戶的存取權。記下產生的重新導向中的

授權代碼

參數。

範例︰重新導向

https://www.google.com/?code=6ru2pkjr9k6jsd4e953fu8lu7

提供代碼

6ru2pkjr9k6jsd4e953fu8lu7

。

若要取得不記名存取權杖，請使用以下格式建立 cURL POST 要求︰


curl --location --request POST <Token Endpoint value>
--header "Origin: https:\\www.google.com" \
--header "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code" \-d "code=<Authorization Code value>" \
-d "client_id=<Client ID value>" \
-d "code_verifier=<Code Verifier value>" \
-d "redirect_uri=https:\\www.google.com"

範例︰


curl --location --request POST https://<hostname>/ccx/oauth2/super/token \
--header "Origin: https:\\www.google.com" \
--header "Content-Type: application/x-www-form-urlencoded" \-d "grant_type=authorization_code" \
-d "code=6ru2pkjr9k6jsd4e953fu8lu7" \
-d "client_id=MjEwNGVmNTgtZWFkNS00MTQ2LWAAZjctNWYxMjBlNTEwMmIz" \
-d "code_verifier=Ii-HfGHYN01J0EZtToJwg9Wmuqss8mNF7_SE343tjMR7i_00HbsPA8sJAfMxlLksnfPsAtBo4SyOkYaYOvn1neUjcFM0oPtoFGQ2n7Uf43DXv2byDqWmd2JViccVbGuQ" \
-d "redirect_uri=https:\\www.google.com"

回應會傳回不記名存取權杖。範例︰

{ "access_token": "eyJ0eXAiOiJhdCtKV1QiLCJhbGciOiJSUzUxMiJ9.eyJzdWIiOiIzNGNkNWZjYTE1ZGQ0MWQ2OThiMDY2NzAxMWU0YzliZCIsImF1ZCI6Imh0dHBzOi8vaS0wZWMxYWVmNmEzYjA0NmUzYi53b3JrZGF5c3V2LmNvbS9jY3gvIiwic2NvcGUiOiJvYXV0aCIsImlzcyI6Imh0dHBzOi8vaS0wZWMxYWVmNmEzYjA0NmUzYi53b3JrZGF5c3V2LmNvbS9jY3gvdfgpL3YxL3N1cGVyIiwiZXhwIjoxNjk3MDQ1ODc0LCJpqwXQiOjE2OTcwMzE0NzQsImp0aSI6ImRHNDJNRFp6YkdVMk0yb3hlWHB6ZERWNWRYZHpPWE5wWVdkbWQerzVjR0o2YWpOcVp6ZHVPSEJxY0dKcWVUVXdhVGRvWVdONGFXWXlZbkZrZW13M2VUSTVZbXRyWkd0dmVtbGtkbnB0T0RaaGRXRnliakYwTjJNNWEzVmxaRzEwZHpkMExqaGlZbVE0WVdGbExUZGtNV0V0TkRNNU15MDVNekl4TFdObVpURXhPVEJtTmpreVlRPT0iLCJjbGllbnRfaWQiOiJNakV3TkdWbU5UZ3RaV0ZrTlMwME1UUTJMV0psWmpjdE5XWXhNakJsTlRFd01tSXoifQ.jrpz70sPohF5_8BuQ-2YbqdV7HDX9mqDLaVxwTQV959pzOrAdYUfzyvvygc973QdanylpIdDGlffiH28_5JziSgdZJTqZnKazM_vs_paI6OcK3bLi5l-I2DYaf5s18q43w3gd0ONa93FT7UiJjkJyUgWK393CHa3KyaGLbb95rjLbldLB8W1sWuiWEC3Yh8ez-XargwVQiUDPaBw5aC65xtmryGGd9Pue6DPtKqQo6fSZPfOR93oc31aBPsxFABGMxoOq6wTkWpIOY9huiah6ge3ElomFgBeXqc55DI5QM1Qvo4_ap7nZGTsZh9kukqIAtv52f7ydWJ3kZduE0Px_A", "token_type": "Bearer" }

若要啟動整合，請從 Workday 取得整合啟動 URL。

使用以下格式建立 cURL POST 要求︰


curl -X "POST" https://<launch URL> \
     -H 'Authorization: Bearer <Bearer Access Token value>' \
     -H 'X-Tenant: <tenantname>' \     
     -H 'Content-Type: text/plain; charset=utf-8'

範例︰


curl -X "POST" https://<hostname>/ccx/cc-cloud-repo/launches/retrieval_sample/RetrieveNStore/ProcessFirstRetrievedDoc \
     -H 'Authorization: Bearer eyJ0eXAiOiJhdCtKV1QiLCJhbGciOiJSUzUxMiJ9.eyJzdWIiOiIzNGNkNWZjYTE1ZGQ0MWQ2OThiMDY2NzAxMWU0YzliZCIsImF1ZCI6Imh0dHBzOi8vaS0wZWMxYWVmNmEzYjA0NmUzYi53b3JrZGF5c3V2LmNvbS9jY3gvIiwic2NvcGUiOiJvYXV0aCIsImlzcyI6Imh0dHBzOi8vaS0wZWMxYWVmNmEzYjA0NmUzYi53b3JrZGF5c3V2LmNvbS9jY3gvdfgpL3YxL3N1cGVyIiwiZXhwIjoxNjk3MDQ1ODc0LCJpqwXQiOjE2OTcwMzE0NzQsImp0aSI6ImRHNDJNRFp6YkdVMk0yb3hlWHB6ZERWNWRYZHpPWE5wWVdkbWQerzVjR0o2YWpOcVp6ZHVPSEJxY0dKcWVUVXdhVGRvWVdONGFXWXlZbkZrZW13M2VUSTVZbXRyWkd0dmVtbGtkbnB0T0RaaGRXRnliakYwTjJNNWEzVmxaRzEwZHpkMExqaGlZbVE0WVdGbExUZGtNV0V0TkRNNU15MDVNekl4TFdObVpURXhPVEJtTmpreVlRPT0iLCJjbGllbnRfaWQiOiJNakV3TkdWbU5UZ3RaV0ZrTlMwME1UUTJMV0psWmpjdE5XWXhNakJsTlRFd01tSXoifQ.jrpz70sPohF5_8BuQ-2YbqdV7HDX9mqDLaVxwTQV959pzOrAdYUfzyvvygc973QdanylpIdDGlffiH28_5JziSgdZJTqZnKazM_vs_paI6OcK3bLi5l-I2DYaf5s18q43w3gd0ONa93FT7UiJjkJyUgWK393CHa3KyaGLbb95rjLbldLB8W1sWuiWEC3Yh8ez-XargwVQiUDPaBw5aC65xtmryGGd9Pue6DPtKqQo6fSZPfOR93oc31aBPsxFABGMxoOq6wTkWpIOY9huiah6ge3ElomFgBeXqc55DI5QM1Qvo4_ap7nZGTsZh9kukqIAtv52f7ydWJ3kZduE0Px_A' \
     -H 'X-Tenant: super' \
     -H 'Content-Type: text/plain; charset=utf-8'

Workday 的 XML 回應確認整合已啟動。