セッションID
REST APIを使用してInformatica Intelligent Cloud Services組織にログインすると、loginリソースはREST APIセッションIDを返します。このセッションIDは、セッション中、後続のほとんどのREST API要求に含めます。
2025年11月3日までは、セッションIDによる認証タイプは常にユーザーのログイン後に使用されます。2025年11月3日からは、組織管理者は次のいずれかの認証タイプを使用するように組織を設定できます。
- •セッションID。組織がセッションIDによる認証タイプを使用している場合、30分間アクティビティが行われないと、セッションIDが期限切れになります。ネットワークまたは予期しない遅延を考慮して、最大2分間の猶予期間が含まれる場合があります。
- •JSON Webトークン（JWT）。組織がJSON Webトークン（JWT）による認証タイプを使用している場合、ログイン応答内に返されるセッションID値はJWTトークンの値になります。カスタムスクリプトを使用する場合は、中断を避けるために、JWTトークンの有効期限が切れる前にスクリプトが自動再認証を処理するようにしてください。詳細については、JWT Supportに関するKnowledgeの記事を参照してください。
ログイン要求以外のすべてのAPI要求のヘッダーには、セッションIDを含めます。ヘッダーに含める属性名は、リソースによって異なります。
- •REST APIバージョン2のリソースの場合は、ヘッダー内で、セッションIDの値を保持するicSessionId属性を使用します。
- •REST APIバージョン3のリソースの場合は、ヘッダー内で、セッションIDの値を保持するINFA-SESSION-ID属性を使用します。
- •その他のリソースの場合は、ヘッダー内で、セッションIDの値を保持するIDS-SESSION-ID属性を使用します。
次の例は、REST APIバージョン2呼び出しのヘッダーにicSessionIdを使用する方法を示しています。
GET https://app.informaticacloud.com/saas/api/v2/licenseInfo/org/<id>
Content-Type: application/xml
Accept: application/xml
icSessionId: <session ID>
次の例は、REST APIバージョン3呼び出しのヘッダーにINFA-SESSION-IDを使用する方法を示しています。
GET https://app.informaticacloud.com/saas/public/core/v3/license/org/{orgId}
Content-Type: application/json
Accept: application/json
INFA-SESSION-ID: 9KA11tLGqxVcGeul8SQBK3
POST要求を送信すると、セッションIDのステータスを確認できます。次のURIを使用して要求を送信します。
/api/v2/user/validSessionId
要求に次の属性を含めます。
- •userName。Informatica Intelligent Cloud Servicesユーザー名。
- •icToken。セッションID。
例えば、次の要求を使用できます。
POST https://app.informaticacloud.com/saas/api/v2/user/validSessionId
Content-Type: application/json
Accept: application/json
{
"@type": "validatedToken",
"userName": "user@informatica.com",
"icToken": "9KA11tLGqxVcGeul8SQBK3"
}
応答では、セッションIDが有効かどうかと、セッションIDの有効期限までの時間（分単位）が返されます。例えば、次の応答を受信します。
{
"@type": "validatedToken",
"timeUntilExpire": 29,
"isValidToken": true
}
注: セッションが1分未満で期限切れになると、timeUntilExpire値は「0」に変わります。セッションの有効期限が切れると、isValidTokenの値が「false」に変わります。認証失敗のリスクを回避するには、timeUntilExpire値が0に変わったときに再認証してください。