DBMS_MFA_ADMINパッケージ

構文

DBMS_MFA_ADMIN.REGISTER_USER (       
       username    IN VARCHAR2,
       type        IN VARCHAR2,
       email       IN CLOB DEFAULT NULL,
       attributes  IN CLOB DEFAULT NULL
 );

パラメータ

例

MFAログオン用にユーザーを登録する例:

BEGIN
    DBMS_MFA_ADMIN.REGISTER_USER(
      user_name        => 'SCOTT',
      type             => 'LOGON',
      email            => 'scott@example.com',
      token_attributes => '{"auth_method":"oma_push"}'
   );
END;
/

MFA属性を設定して、SQLアクセス用のユーザーを登録する例。

BEGIN
    DBMS_MFA_ADMIN.REGISTER_USER( 
      user_name   => 'SCOTT',
      type        => 'SQL ACCESS',
      email       => 'scott@example.com',
      attributes  => '{
             "duration_min"   : 720,
             "read_only"      : true,
             "roles"          : ["DEVELOPER_ROLE", "INFRA_ROLE"],
             "scope"          : "SESSION",
             "slack_member_id": "<slack_user_id>"
      }'
   );
END;
/

使用上のノート

• ユーザーを登録するには、ADMINユーザーとしてログインするか、DBMS_MFA_ADMINパッケージに対する権限を持っている必要があります。

• MFAタイプに応じて、異なるプロバイダを使用してMFAのデータベース・ユーザーを登録できます。DuoおよびOMAはログイン時のMFAでサポートされ、Slack、OMAおよび電子メールはSQLアクセス・トークンのMFAでサポートされます。

• それぞれに個別に登録することで、両方のMFAタイプ(MFAログオンおよびSQLアクセス)に同じユーザーを登録できます。登録ごとに同じまたは異なる電子メール・アドレスを使用できます。構成すると、ユーザーは、ログイン時に登録済電子メール・アドレスへのプッシュ通知を受信し、使用する場合は、ユーザーがSQLアクセスに対してINITIALIZE_SESSIONを実行したときに同じアドレスへの別の通知を受信します。

構文

DBMS_MFA_ADMIN.SET_GLOBAL_TOKEN_ATTRIBUTES(       
    attributes IN VARCHAR2
);

パラメータ

使用上のノート

• トークン属性を設定するには、ADMINユーザーとしてログインするか、DBMS_MFA_ADMINパッケージに対する権限を持っている必要があります。

構文

DBMS_MFA_ADMIN.SET_ATTRIBUTE(            
  username         IN VARCHAR2,
  type             IN VARCHAR2,
  email            IN VARCHAR2 DEFAULT NULL,
  attribute_name   IN VARCHAR2,
  attribute_value  IN CLOB
);

パラメータ

例

BEGIN
  DBMS_MFA_ADMIN.SET_ATTRIBUTE(    
    username         => 'scott',
    type             => 'sql access',
    email            => 'testscott@example.com',
    attribute_name   => 'duration_min',
    attribute_value  => '20');
END;
/

使用上のノート

• usernameパラメータには、MFAに登録されている既存のデータベース・ユーザーを指定する必要があります。

• このプロシージャを実行するには、ADMINユーザーとしてログインするか、DBMS_MFA_ADMINパッケージに対する権限を持っている必要があります。

構文

DBMS_MFA_ADMIN.SET_ATTRIBUTES (          
   username    IN VARCHAR2,
   type        IN VARCHAR2,
   attributes  IN CLOB
);

パラメータ

例

BEGIN
  DBMS_MFA_ADMIN.SET_ATTRIBUTES(
    username   => 'SCOTT',
    type       => 'SQL ACCESS',
    attributes => json_object(
                    'duration_min'        VALUE 15,
                    'email'               VALUE 'testscott@example.com',
                    'scope'               VALUE 'session',
                    'idle_timeout_min'    VALUE 10)
  );
END;
/

使用上のノート

• USERNAMEパラメータには、MFAに登録されている既存のデータベース・ユーザーを指定する必要があります。

• このプロシージャを実行するには、ADMINユーザーとしてログインするか、DBMS_MFA_ADMINパッケージに対する権限を持っている必要があります。

構文

DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION (        
    notification_type  IN VARCHAR2,
    attributes         IN CLOB
);

パラメータ

例

例: EMAIL通知チャネルの構成

BEGIN
    DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION (
    notification_type => 'EMAIL',
    attributes        => JSON_OBJECT(
                          'credential_name'           VALUE 'EMAIL_CRED',
                          'smtp_host'                 VALUE 'smtp.email.us-phoenix-1.oci.oraclecloud.com',
                          'sender'                    VALUE 'send.email@test.com',
                          'smtp_port'                 VALUE 587,
                          'sender_email_display_name' VALUE 'DB SECURITY')
  );
END;
/

例: Slack通知チャネルの構成

BEGIN
  DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION(
        notification_type => 'SLACK',
        attributes             => JSON_OBJECT('credential_name' VALUE 'SLACK_CRED')
  );
END;
/

例: OMA通知チャネルの構成

BEGIN
  DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION(
    notification_type => 'OMA',
    attributes        => JSON_OBJECT(
                                     'credential_name' VALUE 'OMA_CRED_01',
                                     'api_endpoint'    VALUE 'https://idcs-xyz.identity.oraclecloud.com'
    )
  );
END;
/

例: DUO通知チャネルの構成

BEGIN
  DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION(
    notification_type => 'OMA',
    attributes        => JSON_OBJECT(
                                      'credential_name' VALUE 'OMA_CRED_01',
                                      'api_endpoint'    VALUE 'https://idcs-xyz.identity.oraclecloud.com'
    )
  );
END;
/

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_MFA_ADMINパッケージに対する権限を持っている必要があります。

• Slack通知の場合は、必要な資格証明を設定し、ご使用の環境でSlack統合が有効になっていることを確認します。Slack通知は、SQLアクセスMFA操作でのみサポートされます。

  • トークン属性を設定するには、ADMINユーザーとしてログインするか、DBMS_MFA_ADMINパッケージに対する権限を持っている必要があります。

  • オーセンティケータ・アプリケーション・ベースのトークンの場合:

    • MFAに登録するモバイル・デバイスに、サポートされているオーセンティケータ・アプリケーションをインストールします。

    • MFAは、サインインするたびにアクセスできるデバイスを使用して設定する必要があります。別のユーザーがかわりにMFAを有効にすることはできません。

    • MFAを有効にするには、モバイル・デバイスでオーセンティケータ・アプリケーションを使用して、データベース・アクションUIで生成されたQRコードをスキャンします。詳細は、「Oracle Mobile Authenticatorの構成」を参照してください。

      MFAに登録できるモバイル・デバイスは1つのみです。

  • Eメール・ベースのトークン配信の場合、Eメール配信が有効であり、データベース・ユーザーに対して有効なEメール・アドレスが構成されていることを確認します。詳細は、Autonomous AI Databaseでの電子メールの送信を参照してください。
  • Slackベースのトークン配信の場合は、Slackプラグインを構成し、ユーザーのSlack IDをOTP配信用に登録します。詳細は、Autonomous AI DatabaseからのSlack通知の送信を参照してください。

構文

PROCEDURE DBMS_MFA_ADMIN.DEREGISTER_USER (
  username IN VARCHAR2,
  type     IN VARCHAR2,
  email    IN VARCHAR2 DEFAULT NULL
);

パラメータ

例

BEGIN
  DBMS_MFA_ADMIN.DEREGISTER_USER(
    username => 'SCOTT',
    type     => 'SQL ACCESS',
    email    => 'scott@example.com'
  );
END;
/

この例では、指定されたtype (SQL ACCESS)のユーザーSCOTTをMFAから登録解除し、関連付けられた電子メール・アイデンティティ(scott@example.com)をMFA構成から削除します。

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_MFA_ADMINパッケージに対する権限を持っている必要があります。

• ユーザーが複数のEメール・アドレスに登録されている場合は、各Eメール・アドレスを個別に登録解除します。