1. 管理ガイド
  2. Oracle APEX管理サービス
  3. セキュリティの構成
  4. インスタンスの認証制御の構成
  5. インスタンスの認証スキームの構成
  6. ソーシャル・サインインの編集

3.4.7.3.7 ソーシャル・サインインの編集

インスタンスのソーシャル・サインイン認証スキームを編集します。

ソーシャル・サインインは、OpenID ConnectまたはOAuth2標準をサポートする、Google、Facebookなどのソーシャル・ネットワークによる認証をサポートします。

ソーシャル・サインインを編集するには、次の手順を実行します。

  1. APEX管理サービスにサインインします。
  2. 「インスタンスの管理」をクリックします。
  3. 「インスタンスの設定」で、「セキュリティ」をクリックします。
  4. 「開発環境認証スキーム」までスクロールします。
    「ステータス」列に、「カレント」と指定されている認証スキームが示されます。
  5. 「ソーシャル・サインイン」を見つけ、「編集」をクリックします。
    「スキームの編集」ページが表示されます。
  6. 「カレント・スキームにする」をクリックして、アプリケーションでこの認証スキームを使用してユーザーを識別および検証するようにします。
  7. 「認証スキームの編集」の下で、次の手順を実行します。
    • PL/SQLコード - 認証前および認証後のエントリ・ポイント用のプロシージャを含む、コードのPL/SQL無名ブロックを入力します。パフォーマンスを向上させるために、このコードをデータベース内のPL/SQLパッケージに格納することもできます。
    • 認証前のプロシージャ名 - ログイン・ページの送信後および資格証明の検証の直前に実行するプロシージャの名前を指定します。このプロシージャは、PL/SQLコード属性で、またはデータベース内で定義できます。

      ユーザー資格証明チェックがAPEXの外部で実行される認証スキームでは、通常、認証前プロシージャは実行されません。例として、HTTPヘッダー変数、Oracle Application Server Single Sign-On、およびAPEX_AUTHENTICATION.LOGINではなくAPEX_AUTHENTICATION.POST_LOGINを使用するカスタム認証スキームなどがあります。

    • 認証後のプロシージャ名 - 認証ステップ(ログイン資格証明の検証)の後にAPEXのLOGINプロシージャによって実行されるプロシージャの名前を指定します。LOGINプロシージャでは、このコードは、Cookieの設定やセッションの登録などの通常作業の実行後(ただし、目的のアプリケーション・ページにそれをリダイレクトする前)に実行されます。このプロシージャは、PL/SQLコード属性で、またはデータベース内で定義できます。
  8. 「OAuth2資格証明」の下で、次の手順を実行します。
    • クライアントID - 認証プロバイダのクライアントIDを入力します。
    • クライアント・シークレット - 認証プロバイダのクライアント・シークレットを入力します。
    • クライアント・シークレットの確認 - 認証プロバイダのクライアント・シークレットを入力します。
  9. 「認証スキーム属性」の下で、次の手順を実行します。

    ヒント:

    属性についてさらに学習するには、フィールドレベル・ヘルプを参照してください。
    • 認証プロバイダ - プロバイダを選択します。
    • 検出URL - OpenID Connectプロバイダの検出URLを入力します。次に例を示します。

      https://accounts.example.com/.well-known/openid-configuration

    • 有効範囲 - ログインしているユーザーに対して要求する権限をカンマ区切りのリストで入力します。使用可能な値は、認証プロバイダによって異なります。OpenID ConnectおよびGoogleの場合、APEXによって自動的にopenidスコープが追加されます。認証プロバイダは、これらの権限に基づいてユーザー属性を返します。認証後プロシージャにより、APEX_JSON.GET_%ファンクションを使用してこれらの属性を処理できます。
    • 認証URIパラメータ - 認証URIのオプションのパラメータを入力します。サポートされているパラメータについては、認証プロバイダのドキュメントを参照してください。
    • ユーザー名属性 - ユーザー名を含む属性を入力します。サポートされている属性については、認証プロバイダのドキュメントを参照してください。
    • ユーザー名の検証 - 有効にすると、APEXで属性#username#_verifiedが検索されます(たとえば、ユーザー名属性がemailの場合はemail_verified)。これがfalseに設定されている場合、そのユーザー名は受け入れられません。
    • 追加ユーザー属性 - 追加のユーザー・データ属性をカンマ区切りのリストで入力します。サポートされている属性については、認証プロバイダのドキュメントを参照してください。
    • ログアウトURL - この属性を使用して、認証プロバイダからログアウトするためのURLを指定します。OpenID Connectの場合、APEXでは、end_sessionエンドポイントが「検出URL」で定義されていれば、それが自動的に使用されます。その他の場合は、URLで#ID_TOKEN#および#REDIRECT_URI#を使用して、ログイン時に返されたIDトークンと、インスタンス上の/apexへの完全なURL (https://www.example.com/apex/apexなど)に置き換えることができます。なお、リダイレクトURIは、多くの場合、認証プロバイダに登録する必要があります。
  10. 変更を保存するには、「変更の適用」をクリックします。

親トピック: インスタンスの認証スキームの構成