トークンエクスチェンジグラントタイプ（OAuth）

セキュリティトークンをIndeedのアクセストークンと交換します。

 

法的注意

By using this API and its documentation and building an integration, you agree to the Additional API Terms and Guidelines.

Indeedのトークンエクスチェンジグラントタイプ（OAuth）を使用して、Indeedのアクセストークンを生成します。

トークンエクスチェンジグラントタイプ（OAuth）の手順

この連携を開始する場合、または質問がある場合は、indeed-ciam-integrations-support@indeed.comにお問い合わせください。

次の手順を実行します。

トークンエクスチェンジグラントタイプ

#	手順
1.	アプリを登録する。
2.	Authorization Basicヘッダー値を生成する。
3.	アクセストークンを取得する。

アプリを登録する

日本のみ

1. Manage app credentialsページでIndeedアカウントにサインインし、Register new applicationを選択します。
2. Provide basic informationページで、アプリ名と説明を入力します。Credential typeではOAuth 2.0を選択し、Save and continueを選択します。
3. Select OAuth grant typesページで、Client credentialsを選択し、Save and continueを選択します。
4. Provide additional informationページで、必要に応じて詳細を追加し、Save and continueを選択します。
5. Preview appページでアプリ情報を確認し、Complete registrationを選択します。
6. CredentialsページでクライアントIDとシークレットを控えます。シークレットは共有しないでください。
7. 登録済みのOAuthクライアントをトークンエクスチェンジの許可リストに追加できるように、クライアントIDをIndeedに共有します。

日本以外

Indeed Apply XML 連携を構築するには、Indeed Client Success team にお問い合わせください。Developer Agreement に署名すると、Indeed がお客様の製品に Indeed API とサービスを連携するアプリをセットアップします。

Partner Console にサインインして、アプリとその Indeed Apply API token 認証情報を確認します。

• APIトークン認証情報は、クライアントIDとクライアントシークレットです。
• Indeedに投稿する各求人にAPIトークンを含めます。

Authorization Basicヘッダー値を生成する

See also Basic Authentication Scheme in RFC 2617: HTTP Authentication: Basic and Digest Access Authentication.

To generate the Authorization Basic header value:

1. Concatenate the client_id and client_secret with a colon (:) as a separator.

   base64.encode("<client_id>:<client_secret>");

2. Apply the Base64-encoding algorithm to the string:

   base64.encode("5e175cbb7f88e2048bd95323bbc9ca2fcec32ad60f95f7ee66ab53e099abe6f3:pJ4qRe2sdXRP0Whr3bwz9D37exFuuOtqJDRHMmmlLWV7J25rH7oItrPNCKzhaQf2");

3. Pass the Base64-encoded string as a basic HTTP Authorization header:

   Authorization: Basic NWUxNzVjYmI3Zjg4ZTIwNDhiZDk1MzIzYmJjOWNhMmZjZWMzMmFkNjBmOTVmN2VlNjZhYjUzZTA5OWFiZTZmMzpwSjRxUmUyc2RYUlAwV2hyM2J3ejlEMzdleEZ1dU90cUpEUkhNbW1sTFdWN0oyNXJIN29JdHJQTkNLemhhUWYy

アクセストークンを取得する

トークンエクスチェンジグラントタイプを使用してアクセストークンを取得するには、次のHTTPリクエストヘッダーを指定して、https://apis.indeed.com/oauth/v2/tokensエンドポイントにPOSTリクエストを送信します。

POST https://apis.indeed.com/oauth/v2/tokens
Content-Type: application/json
Authorization: Basic czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3

grant_type=urn:ietf:params:oauth:grant-type:token-exchange&subject_token=xxxxx.yyyyy.zzzzz&subject_token_type=urn:ietf:params:oauth:token-type:id_token

アクセストークンを取得するには、Authorization: Bearer <access_token>およびContent-Typeリクエストヘッダーと、リクエストボディパラメーターを指定して、https://apis.indeed.com/oauth/v2/tokensエンドポイントにPOSTリクエストを送信します。

このcurlの例は、アクセストークンを取得します。

curl -L 'https://apis.indeed.com/oauth/v2/tokens' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'Authorization: Bearer <access_token>' \
  -d 'grant_type=urn:ietf:params:oauth:grant-type:token-exchange' \
  -d 'client_id=<client_id>' \
  -d 'client_secret=<client_secret>' \
  -d 'subject_token_type=urn:ietf:params:oauth:token-type:id_token' \
  -d 'scope=email offline_access' \
  -d 'subject_token=xxxxx.yyyyy.zzzzz'

リクエストヘッダーは次のとおりです。

アクセストークンを取得する

ヘッダー	値
Authorization	Bearer <token> <token>は、お客様のアクセストークンです。
Content-Type	application/json

oauth/v2/tokensのリクエストボディパラメーターは次のとおりです。

oauth/v2/tokensリクエストボディパラメーター

リクエストボディパラメーター	必須	値
grant_type	✔	urn:ietf:params:oauth:grant-type:token-exchange Type: string
scope	任意	発行されるIndeedトークンに付与されるスコープです。 Scopesをご覧ください。 例: openid
subject_token	✔	リクエストの代行対象となる当事者の身元を表すトークンです。トークン発行者は、Indeedがそのトークンを検証できる方法を提供する必要があります。 IndeedはIDトークンのみをサポートします。 例: xxxxx.yyyyy.zzzzz
subject_token_type	✔	subject_tokenフィールドで渡すトークンのタイプです。 例: urn:ietf:params:oauth:token-type:id_token.

成功したJSONレスポンスは次のとおりです。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "access_token": "<access_token>",
  "scope": ""
  "issued_token_type": "urn:ietf:params:oauth:token-type:access_token",
  "token_type": "Bearer",
  "expires_in": 1419356238
}

失敗したJSONレスポンスは次のとおりです。

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "error": "invalid_request"
}

レスポンスフィールドは次のとおりです。

レスポンスフィールド

レスポンスフィールド	Type	説明
access_token	String	お客様のアクセストークンです。 例: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6Ikpv[...]
error	String	エラータイプです。 例: "error": "invalid_request"
error_description	String	エラーの説明です。 例: "error_description": "Invalid Request."
expires_in	Integer	トークンは1時間（3600秒）有効です。 例: 3600
issued_token_type	String	発行されたトークンのタイプです。 例: urn:ietf:params:oauth:token-type:access_token
scope	String	アプリに実際に付与された権限です。たとえば、emailおよびoffline_accessスコープです。スコープはスペース区切りです。 例: email offline_access Scopesをご覧ください。
token_type	String	値は常にBearerです。 例: Bearer

IDトークン

Indeedは、指定されたIDトークン内のこれらのクレームを検査します。

OpenID Connect Core 1.0 incorporating errata set 2 – Standard Claimsで必須とされるフィールドに加え、IndeedのIdentity systemは、利用可能な場合にこれらのフィールドを検査します。

IDトークンは、JSON Web Token (JWT)です。次の表は、JWT本文でサポートされるフィールドと必須フィールドを定義しています。

OpenID Connect Core 1.0 incorporating errata set 2 – Standard Claimsでは、auth_ipを除くすべてのフィールドが定義されています。

OpenID Connect Core 1.0 incorporating errata set 2 – Standard Claimsもご覧ください。

IDトークン

フィールド	必須	説明
aud Type: string		IDトークンの想定される受信者です。トークンエクスチェンジフローでは、このフィールドにはトークンを受け取った外部アプリケーションのクライアントIDが含まれます。外部アプリケーションがこのトークンを交換のために提示する場合、この値は元のオーディエンスを識別します。 例: 6ae943d9e10b6576f51185ca5ce3353f
auth_ip Type: string		ユーザーがサインインしたときの、正しい形式のIPv4アドレスです。RFC 1918をご覧ください。 例: 160.67.221.147
auth_time Type: JSON number		ユーザーが最後に認証された時刻です。 例: 1741209846
exp Type: JSON number		Indeedは有効期限後のトークンを拒否します。発行されるアクセストークンは、exp値と一致します。 例: 1741209848
iat Type: JSON number	✔ すべての連携で必須	JWTが発行された時刻です。 例: 1741209847
iss Type: string		JWTを発行したエンティティの一意のIDです。発行システムのURIです。 例: https://partner.com/
sub Type: string	✔ すべての連携で必須	アイデンティティプロバイダー内のユーザーIDです。 SCIMのexternalIdにマッピングされる必要があります。 例: CU1234
name Type: string		エンドユーザーの氏名です。ロケールと設定に基づいて表示用に書式設定されます。 例: Job Seeker
email Type: string	✔ すべての連携で必須	ユーザーの優先メールアドレスです。RFC 5322のAddr-Spec Specificationに従う必要があります。 例: jobseeker123@indeed.com
email_verified Type: boolean		この値を省略すると、Indeedはパートナーがユーザーのメールアドレスを検証していないと見なします。 例: true or false
family_name Type: string	✔ 一部の連携で必須	ユーザーの姓です。文化によっては、姓が複数ある場合があります。複数の姓はスペースで区切ります。 例: Seeker
given_name Type: string		ユーザーの名です。文化によっては、名が複数ある場合があります。複数の名はスペースで区切ります。 例: Job
locale Type: string		ユーザーのロケールです。BCP47（RFC 5646）言語タグです。通常は、小文字のISO 639 Alpha-2 ISO639言語コードと大文字のISO 3166-1 Alpha-2 ISO3166‑1国コードをダッシュで区切ります。 例: en_US
phone_number Type: string		ユーザーの電話番号です。E164形式に従う必要があります。 例: +1 (425) 555-1212
phone_number_verified Type: boolean		電話番号が検証済みかどうかです。電話番号を含めてもphone_number_verifiedを省略した場合、Indeedはアイデンティティプロバイダーがユーザーの電話番号を検証していないと見なします。 例: true or false
updated_at Type: JSON number		エンドユーザーの情報が最後に更新された時刻です。OpenID Connect仕様で定義されています。 例: 1741201234

RFC

• RFC 1918: Address Allocation for Private Internets
• RFC 5322: Internet Message Format
• RFC 5646: Tags for Identifying Languages
• RFC 8693: OAuth 2.0 Token Exchange

関連項目

• HTTPリクエストヘッダー
• oauth/v2/tokensエンドポイント
• エラーレスポンス
• OAuthエラーのトラブルシューティング

 

このページは役に立ちましたか？