7.9 LOGINプロシージャ

このプロシージャは、カレント・セッションのユーザーを認証します。

ログイン・プロセスのステップは、次のとおりです。

  1. 認証スキームの認証前プロシージャを実行します。
  2. 認証スキームの認証ファンクションを実行して、ユーザー資格証明(p_usernamep_password)をチェックし、成功した場合はTRUEを戻します。
  3. 結果がTRUEの場合は、認証後の処理を実行します。
  4. 結果がTRUEの場合は、セッション表にユーザー名を保存します。
  5. 結果がTRUEの場合: リダイレクトURLをディープ・リンクに設定します。
  6. 結果がFALSEの場合: リダイレクトURLをカレント・ページに設定し、notification_msgパラメータにエラー・メッセージを含めます。
  7. 認証結果を記録します。
  8. リダイレクトします。

構文

APEX_AUTHENTICATION.LOGIN ( 
    p_username              IN VARCHAR2, 
    p_password              IN VARCHAR2, 
    p_uppercase_username    IN BOOLEAN  DEFAULT TRUE
    p_set_persistent_auth   IN BOOLEAN  DEFAULT FALSE ); 

パラメータ

表7-4 LOGINのパラメータ

パラメータ 説明
p_username ユーザーの名前。
p_password ユーザーのパスワード。
p_uppercase_username TRUEの場合、p_usernameは大文字に変換されます。
p_set_persistent_auth TRUEの場合、永続認証Cookieが設定されます。インスタンス・レベルで永続認証を有効にする必要があります。

この例では、認証スキームにユーザー資格証明、ユーザー名およびパスワードを渡します。

apex_authentication.login('JOE USER', 'mysecret');