前のトピック: 認証情報の作成次のトピック: ArcotID PKI の入力要素


共通の入力要素

以下の表に、ユーザおよび共通の認証情報の要素のリストを示します。

要素

必須

説明

共通のユーザ入力

clientTxnId

いいえ

呼び出し元アプリケーションが含めることができる一意のトランザクション識別子を指定します。 この識別子は、関連するトランザクションの追跡に役立ちます。

userName

はい

認証情報を作成する必要があるユーザの一意の識別子を指定します。

orgName

いいえ

ユーザが属する組織の名前を指定します。

additionalInput/pairs

いいえ

AuthMinder の additionalInput 要素を使用すると、追加情報を指定して AuthMinder の認証機能を拡張したい場合に、追加入力を設定できます。 その場合、名前と値のペアで追加情報を設定する必要があります。

  • name (作成するキー ペアの名前)
  • value (名前に対応する値)

事前定義済みの追加入力パラメータの一部を以下に示します。

  • AR_WF_LOCALE_ID
    呼び出し元アプリケーションにメッセージを返す際に AuthMinder で使用するロケールを指定します。
  • AR_WF_CALLER_ID
    トランザクションの追跡に役立ちます。 この情報は、セッション ID またはクライアント トランザクション ID (clientTxnId)を使用して指定できます。

    注: additionalInput 要素はリクエスト メッセージの最後で使用できます。 これらの要素は複数追加できます。

共通の認証情報入力

参照してください。

いいえ

各認証情報に対してアプリケーションで保持する追加情報を指定します。

たとえば、ユーザに 6 つ以上のシステム上で ArcotID PKI をダウンロードさせたくない場合に、その旨を指定した属性を作成できます。

カスタム属性は名前と値のペアで設定できます。

  • 名前
    作成するカスタム属性の名前を示します。

  • 名前に対応する値を示します。

profileName

いいえ

認証情報のプロファイル名を指定します。 渡さない場合は、組織のデフォルト プロファイルが使用されます。 渡す場合は、指定したプロファイル名が組織レベルで利用可能である必要があります。

validityEndTime

いいえ

認証情報の有効期間を指定します。 タイムスタンプの形式は XS:Timestamp に従います。

validityEndTimeEx

いいえ

認証情報の有効期間を指定します。 validityEndTimeEx 要素では ArcotDateType 構造が使用されます。

validityEndTimeEx 要素には以下の値があります。

  • year
    有効期間の開始/終了日時の年。
  • month
    有効期間の開始/終了日時の月。
  • day
    有効期間の開始/終了日時の日。
  • hour
    有効期間の開始/終了日時の時。
  • minute
    有効期間の開始/終了日時の分。

 

 

  • second
    有効期間の開始/終了日時の秒。
  • dateType
    有効期間の開始日または終了日。 以下の日付タイプがサポートされています。
    1
    AuthMinder サーバの現在の日付を使用して、有効期間または無効期間を設定します。
    2
    認証情報が永久に有効で、期限切れにならないことを示します。
    3
    指定された日付を使用して有効期間または無効期間を設定します。
    4
    無効期間の開始日に対応する相対的な日付を使用します。 たとえば、相対日付を 1 か月とした場合、無効期間の終了日は開始日の 1 か月後になります。

disableStartTime

いいえ

ユーザが休暇または長期休暇中は、該当ユーザのクレデンシャルをその期間に限り無効にし、所定の期間経過後に自動的に有効にすることができます。 この機能によってクレデンシャルの有効化処理が合理化され、ユーザが User Administrator (UA)にリクエストを行う必要がなくなります。

disableStartTime 要素は、認証情報の無効期間の開始日時を指定するために使用されます。 この要素の値は validityEndTimeEx と同じです。

disableEndTime

いいえ

認証情報の無効期間の終了日時を指定します。 この要素の値は validityEndTimeEx と同じです。