10.8 LOGINプロシージャ

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

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

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

構文

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 ); 

パラメータ

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

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

BEGIN
    apex_authentication.login (
        p_username => 'JOE USER',
        p_password => 'mysecret' );
END;