DBMS_MFA_ADMIN-Package

Syntax

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

Parameter

Beispiele

Beispiel für die Registrierung eines Benutzers für die MFA-Anmeldung:

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

Beispiel für die Registrierung eines Benutzers für den SQL-Zugriff, indem die MFA-Attribute festgelegt werden.

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

Hinweise zur Verwendung

• Um einen Benutzer zu registrieren, müssen Sie als Benutzer ADMIN angemeldet sein oder über Berechtigungen für das Package DBMS_MFA_ADMIN verfügen.

• Sie können Datenbankbenutzer für MFA mit verschiedenen Providern registrieren, je nach MFA-Typ: Duo und OMA werden für Anmeldezeit-MFA unterstützt, während Slack, OMA und E-Mail für SQL Access Token MFA unterstützt werden.

• Sie können denselben Benutzer für beide MFA-Typen (MFA-Anmeldung und SQL-Zugriff) registrieren, indem Sie ihn separat für jeden Benutzer registrieren. Sie können für jede Registrierung dieselbe oder eine andere E-Mail-Adresse verwenden. Nach der Konfiguration erhält der Benutzer eine Push-Benachrichtigung an die registrierte E-Mail-Adresse bei der Anmeldung und eine weitere Benachrichtigung an dieselbe Adresse, falls verwendet, wenn der Benutzer INITIALIZE_SESSION für SQL Access ausführt.

Syntax

DBMS_MFA_ADMIN.SET_GLOBAL_TOKEN_ATTRIBUTES(       
    attributes IN VARCHAR2
);

Parameter

Hinweis zur Verwendung

• Um die Tokenattribute festzulegen, müssen Sie als Benutzer ADMIN angemeldet sein oder über Berechtigungen für das Package DBMS_MFA_ADMIN verfügen.

Syntax

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

Parameter

Beispiel

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

Hinweise zur Verwendung

• Der Parameter username muss einen vorhandenen Datenbankbenutzer angeben, der für MFA registriert ist.

• Sie müssen als Benutzer ADMIN angemeldet sein oder über Berechtigungen für das Package DBMS_MFA_ADMIN verfügen, um diese Prozedur ausführen zu können.

Syntax

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

Parameter

Beispiel

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

Hinweise zur Verwendung

• Der Parameter USERNAME muss einen vorhandenen Datenbankbenutzer angeben, der für MFA registriert ist.

• Sie müssen als Benutzer ADMIN angemeldet sein oder über Berechtigungen für das Package DBMS_MFA_ADMIN verfügen, um diese Prozedur ausführen zu können.

Syntax

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

Parameter

Beispiele

Beispiel: EMAIL-Benachrichtigungskanal konfigurieren

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

Beispiel: Slack-Benachrichtigungskanal konfigurieren

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

Beispiel: OMA-Benachrichtigungskanal konfigurieren

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

Beispiel: DUO-Benachrichtigungskanal konfigurieren

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

Hinweise zur Verwendung

• Um diese Prozedur ausführen zu können, müssen Sie als Benutzer ADMIN angemeldet sein oder über Berechtigungen für das Package DBMS_MFA_ADMIN verfügen.

• Legen Sie für Slack-Benachrichtigungen die erforderlichen Zugangsdaten fest, und bestätigen Sie, dass die Slack-Integration in Ihrer Umgebung aktiviert ist. Slack-Benachrichtigungen werden nur für MFA-Vorgänge mit SQL-Zugriff unterstützt.

  • Um die Tokenattribute festzulegen, müssen Sie als Benutzer ADMIN angemeldet sein oder über Berechtigungen für das Package DBMS_MFA_ADMIN verfügen.

  • Für Authenticator-App-basierte Token:

    • Installieren Sie eine unterstützte Authentikator-App auf dem Mobilgerät, das Sie für MFA registrieren wollen.

    • Sie müssen MFA mit einem Gerät einrichten, auf das Sie bei jeder Anmeldung zugreifen können. MFA kann in Ihrem Namen nicht von einem anderen Benutzer aktiviert werden.

    • Um MFA zu aktivieren, verwenden Sie die Authentifizierungsapp auf Ihrem Mobilgerät, um den in der Datenbankaktions-UI generierten QR-Code zu scannen. Weitere Informationen finden Sie unter Oracle Mobile Authenticator konfigurieren.

      Sie können nur ein Mobilgerät für MFA registrieren.

  • Stellen Sie bei der E-Mail-basierten Tokenzustellung sicher, dass die E-Mail-Zustellung aktiviert ist und dass gültige E-Mail-Adressen für Datenbankbenutzer konfiguriert sind. Weitere Informationen finden Sie unter E-Mail an autonome KI-Datenbank senden.
  • Konfigurieren Sie für die Slack-basierte Tokenzustellung das Slack-Plug-in, und registrieren Sie die Slack-ID des Benutzers für die OTP-Zustellung. Weitere Informationen finden Sie unter Slack-Benachrichtigungen aus Autonomous AI Database senden.

Syntax

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

Parameter

Beispiele

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

In diesem Beispiel wird die Registrierung des Benutzers SCOTT von der MFA für die angegebene type (SQL ACCESS) aufgehoben, und die zugehörige E-Mail-Identität (scott@example.com) wird aus der MFA-Konfiguration entfernt.

Hinweis zur Verwendung

• Um diese Prozedur ausführen zu können, müssen Sie als Benutzer ADMIN angemeldet sein oder über Berechtigungen für das Package DBMS_MFA_ADMIN verfügen.

• Wenn ein Benutzer mit mehreren E-Mail-Adressen registriert ist, heben Sie die Registrierung jeder E-Mail-Adresse einzeln auf.