access_token のアクティブ期間を分単位で設定します。
&GAMSecurityPolicy.OauthTokenExpire = Number_Minutes
入力値の説明:
&GAMSecurityPolicy
GAMSecurityPolicy データタイプに基づく変数です。
Number_Minutes access_token のアクティブ期間を分単位で設定します。
このプロパティでは、access_token のアクティブ期間を分単位で設定できます。
既定値は 0 です。これはトークンが期限切れになることはないことを意味します。
安全なアプリケーションに接続するために、最終的なユーザーはオーソライズされたユーザー名/パスワードを知っている必要があります。これらの資格情報は、アプリケーションのインストール時にデバイスにダウンロードされた client_id と一緒に、サーバーアプリケーションとの最初の接続を確立するために使用されます (詳しくは、「
GeneXus で安全な REST Web サービスを開発する方法」を参照してください)。
ユーザーがアプリケーションに接続しようとすると、ログインがユーザーに表示されます。初めて接続しようとしたときに、ユーザー名、パスワード、client_id を使用してサーバーへの POST が実行されます。次に、HTTP 応答で access_token が返され、これが今後この接続で常に使用されることになります。
この access_token はデバイスに格納され、ユーザーが接続している間は保持されるか、GAMSecurityPolicy
外部オブジェクトの
[ OauthTokenExpire ] プロパティの値に応じて、定期的にリセットされます。
access_token はデバイスのキャッシュに格納され、それが有効な (ユーザーがログアウトしていない) 間は、再びログイン画面が表示されることはありません。
ユーザーがアプリケーションからログアウトすると、ローカルセッションは破棄されて、デバイスのローカルキャッシュが破棄されます。
注: GAM Backoffice を使用する場合、このプロパティは「Token expiration (minutes)」というデスクリプションとともに表示されます。
GAMExampleEntrySecurityPolicy
Web Panel オブジェクトは、このプロパティを使用したサンプルです。
GeneXus コードでこのプロパティを設定する場合 (
GAM API を使用)、構文は次のようになります:
&GAMSecurityPolicy.OauthTokenExpire = &OauthTokenExpire
注:
1. トークンの有効期限の時間切れ基準は、Web セッションの有効期限のタイムアウトとは異なります。後者は非アクティブな時間で、前者は経過時間です。
2. [
Token expiration (minutes) ] プロパティは、自動的に登録されたユーザーでは考慮されません。
GAMSecurityPolicy 外部オブジェクトの [ OauthTokenMaximumRenovations ] プロパティ GAM を使用したアプリケーションでのセキュリティセッション管理