Ensemble DBMS_MFA_ADMIN
L'ensemble DBMS_MFA_ADMIN facilite et configure l'accès au jeton SQL.
- Sommaire des sous-programmes DBMS_MFA_ADMIN
Résume les sous-programmes inclus dans l'ensembleDBMS_MFA_ADMIN.
Sommaire des sous-programmes DBMS_MFA_ADMIN
Récapitule les sous-programmes inclus dans l'ensemble DBMS_MFA_ADMIN.
- Procédure REGISTER_USER
La procédureDBMS_MFA_ADMIN.REGISTER_USERenregistre un utilisateur de base de données existant pour l'authentification multifacteur en l'associant à une adresse de courriel en tant qu'identité externe. Vous pouvez activer l'authentification multifacteur pour l'authentification de connexion, l'accès SQL ou les deux. Il prend en charge les applications de messagerie, Slack et d'authentification pour fournir des jetons d'accès sécurisés. - Procédure SET_GLOBAL_TOKEN_ATTRIBUTES
La procédureDBMS_MFA_ADMIN.SET_GLOBAL_TOKEN_ATTRIBUTESdéfinit ou met à jour globalement les attributs d'authentification multifacteur du jeton d'accès SQL pour tous les utilisateurs enregistrés. - Procédure SET_ATTRIBUTE
Le paramètreDBMS_MFA_ADMIN.SET_ATTRIBUTEdéfinit ou met à jour un seul attribut d'authentification multifacteur pour un utilisateur enregistré et remplace toute valeur par défaut globale applicable pour cet attribut. - Procédure SET_ATTRIBUTES
La procédureDBMS_MFA_ADMIN.SET_ATTRIBUTESdéfinit ou met à jour un ou plusieurs attributs d'authentification multifacteur pour un utilisateur enregistré et remplace toutes les valeurs globales par défaut applicables à ces attributs. - Procédure CONFIGURE_NOTIFICATION
La procédureDBMS_MFA_ADMIN.CONFIGURE_NOTIFICATIONconfigure les canaux par lesquels les jetons d'authentification multifacteur sont envoyés aux utilisateurs enregistrés. Cela inclut la définition du mode de transmission et des propriétés propres au canal requises pour la distribution de jetons. - Procédure DEREGISTER_USER
La procédureDBMS_MFA_ADMIN.DEREGISTER_USERsupprime un utilisateur de base de données actuellement inscrit pour l'authentification multifacteur. Une fois l'utilisateur supprimé, l'authentification multifacteur n'est plus appliquée pour ce compte et l'utilisateur peut s'authentifier sans second facteur.
Rubrique parent : Ensemble DBMS_MFA_ADMIN
REGISTER_USER Procédure
La procédure DBMS_MFA_ADMIN.REGISTER_USER enregistre un utilisateur de base de données existant pour l'authentification multifacteur en associant l'utilisateur à une adresse de courriel en tant qu'identité externe. Vous pouvez activer l'authentification multifacteur pour l'authentification de connexion, l'accès SQL ou les deux. Il prend en charge les applications de messagerie, Slack et d'authentification pour fournir des jetons d'accès sécurisés.
Syntaxe
DBMS_MFA_ADMIN.REGISTER_USER (
username IN VARCHAR2,
type IN VARCHAR2,
email IN CLOB DEFAULT NULL,
attributes IN CLOB DEFAULT NULL
);
Paramètres
| Paramètre | Description |
|---|---|
|
|
Indique le nom d'utilisateur pour lequel l'authentification multifacteur doit être appliquée. |
|
|
Spécifie l'attribut d'authentification multifacteur qui contrôle le moment où l'authentification multifacteur est appliquée pour l'utilisateur. type accepte les valeurs suivantes :
|
|
|
Spécifie l'adresse de courriel à associer à l'utilisateur pour l'authentification multifacteur. |
|
|
Spécifie les attributs d'authentification multifacteur au format JSON. Utilisez
|
Exemples
Exemple pour enregistrer un utilisateur pour la connexion à l'authentification multifacteur :
BEGIN
DBMS_MFA_ADMIN.REGISTER_USER(
user_name => 'SCOTT',
type => 'LOGON',
email => 'scott@example.com',
token_attributes => '{"auth_method":"oma_push"}'
);
END;
/
Exemple d'enregistrement d'un utilisateur pour un accès SQL en définissant les attributs d'authentification multifacteur.
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;
/
Notes d'utilisation
-
Pour enregistrer un utilisateur, vous devez être connecté en tant qu'utilisateur
ADMINou disposer de privilèges sur l'ensembleDBMS_MFA_ADMIN. -
Vous pouvez enregistrer des utilisateurs de base de données pour l'authentification multifacteur à l'aide de différents fournisseurs selon le type d'authentification multifacteur : Duo et OMA sont pris en charge pour l'authentification multifacteur lors de la connexion, tandis que Slack, OMA, Duo et courriel sont pris en charge pour l'authentification multifacteur de jeton d'accès SQL.
-
Vous pouvez enregistrer le même utilisateur pour les deux types d'authentification multifacteur (authentification multifacteur et accès SQL) en les enregistrant séparément pour chacun d'eux. Vous pouvez utiliser la même adresse de courriel ou une adresse différente pour chaque inscription. Une fois configuré, l'utilisateur reçoit un avis poussé à l'adresse de courriel enregistrée lors de la connexion, et un autre avis, à la même adresse, s'il est utilisé, lorsque l'utilisateur exécute
INITIALIZE_SESSIONpour SQL Access.
Rubrique parent : Sommaire des sous-programmes DBMS_MFA_ADMIN
SET_GLOBAL_TOKEN_ATTRIBUTES Procédure
La procédure DBMS_MFA_ADMIN.SET_GLOBAL_TOKEN_ATTRIBUTES définit ou met à jour globalement les attributs d'authentification multifacteur de jeton d'accès SQL pour tous les utilisateurs enregistrés.
Syntaxe
DBMS_MFA_ADMIN.SET_GLOBAL_TOKEN_ATTRIBUTES(
attributes IN VARCHAR2
);Paramètres
| Paramètre | Description |
|---|---|
|
|
Spécifie les attributs de jeton au format JSON pour générer un jeton d'accès. Les valeurs valides sont :
|
Note d'utilisation
-
Pour définir les attributs de jeton, vous devez être connecté en tant qu'utilisateur
ADMINou disposer de privilèges sur l'ensembleDBMS_MFA_ADMIN.
Rubrique parent : Sommaire des sous-programmes DBMS_MFA_ADMIN
SET_ATTRIBUTE Procédure
DBMS_MFA_ADMIN.SET_ATTRIBUTE définit ou met à jour un seul attribut d'authentification multifacteur pour un utilisateur enregistré et remplace toute valeur par défaut globale applicable pour cet attribut.
Pour l'authentification multifacteur pour le temps de connexion,
auth_method est le seul attribut pris en charge.
Syntaxe
DBMS_MFA_ADMIN.SET_ATTRIBUTE(
username IN VARCHAR2,
type IN VARCHAR2,
email IN VARCHAR2 DEFAULT NULL,
attribute_name IN VARCHAR2,
attribute_value IN CLOB
);Paramètres
| Paramètre | Description |
|---|---|
|
|
Indique l'utilisateur de base de données dont l'attribut d'authentification multifacteur doit être mis à jour. |
|
|
Spécifie l'attribut d'authentification multifacteur qui contrôle le moment où l'authentification multifacteur est appliquée pour l'utilisateur. Les valeurs valides sont :
|
|
|
Spécifie l'adresse de courriel à associer à l'utilisateur pour l'authentification multifacteur. Ce paramètre est facultatif et prend par défaut la valeur |
|
|
Spécifie le nom de l'attribut d'authentification multifacteur à mettre à jour. Les valeurs valides sont :
|
|
|
Nouvelle valeur pour l'attribut spécifié. |
Exemple
SCOTT :BEGIN
DBMS_MFA_ADMIN.SET_ATTRIBUTE(
username => 'scott',
type => 'sql access',
email => 'testscott@example.com',
attribute_name => 'duration_min',
attribute_value => '20');
END;
/Notes d'utilisation
-
Le paramètre
usernamedoit spécifier un utilisateur de base de données existant enregistré pour l'authentification multifacteur. -
Vous devez être connecté en tant qu'utilisateur
ADMINou disposer de privilèges sur l'ensembleDBMS_MFA_ADMINpour exécuter cette procédure.
Rubrique parent : Sommaire des sous-programmes DBMS_MFA_ADMIN
SET_ATTRIBUTES Procédure
La procédure DBMS_MFA_ADMIN.SET_ATTRIBUTES définit ou met à jour un ou plusieurs attributs d'authentification multifacteur pour un utilisateur enregistré et remplace toutes les valeurs par défaut globales applicables à ces attributs.
Pour l'authentification multifacteur pour le temps de connexion,
auth_method est le seul attribut pris en charge.
Syntaxe
DBMS_MFA_ADMIN.SET_ATTRIBUTES (
username IN VARCHAR2,
type IN VARCHAR2,
attributes IN CLOB
);
Paramètres
| Paramètre | Description |
|---|---|
|
|
Indique le nom d'utilisateur dont les attributs d'authentification multifacteur doivent être mis à jour. |
|
|
Spécifie l'attribut d'authentification multifacteur qui contrôle le moment où l'authentification multifacteur est appliquée pour l'utilisateur. Les valeurs valides sont :
|
attributes |
Spécifie les attributs d'authentification multifacteur au format JSON. Les valeurs valides sont :
|
Exemple
SCOTT :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;
/Notes d'utilisation
-
Le paramètre
USERNAMEdoit spécifier un utilisateur de base de données existant enregistré pour l'authentification multifacteur. -
Vous devez être connecté en tant qu'utilisateur
ADMINou disposer de privilèges sur l'ensembleDBMS_MFA_ADMINpour exécuter cette procédure.
Rubrique parent : Sommaire des sous-programmes DBMS_MFA_ADMIN
CONFIGURE_NOTIFICATION Procédure
La procédure DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION configure les canaux par lesquels les jetons d'authentification multifacteur sont envoyés aux utilisateurs enregistrés. Cela inclut la définition du mode de transmission et des propriétés propres au canal requises pour la distribution de jetons.
Syntaxe
DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION (
notification_type IN VARCHAR2,
attributes IN CLOB
);
Paramètres
| Paramètre | Description |
|---|---|
|
|
Spécifie le type de canal d'avis à configurer. Les valeurs valides sont les suivantes : |
|
|
Fournit les détails de configuration du canal d'avis spécifié au format JSON. Voici les types d'attribut valides pour chacun de ces canaux d'avis : EMAIL : Requis pour la configuration de la connexion à l'authentification multifacteur; mot de passe à usage unique par courriel pris en charge uniquement pour l'authentification multifacteur de jeton d'accès SQL
SLACK : Prise en charge uniquement pour l'authentification multifacteur de jeton d'accès SQL
OMA : Prise en charge de l'authentification multifacteur de jeton d'accidents de connexion et SQL
DUO : Prise en charge uniquement pour l'authentification multifacteur de connexion :
|
Exemples
Exemple : Configurer le canal d'avis 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;
/
Exemple : Configurer le canal d'avis Slack
BEGIN
DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION(
notification_type => 'SLACK',
attributes => JSON_OBJECT('credential_name' VALUE 'SLACK_CRED')
);
END;
/Exemple : Configurer un canal d'avis 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;
/
Exemple : Configurer le canal d'avis 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;
/Notes d'utilisation
-
Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur
ADMINou disposer de privilèges sur l'ensembleDBMS_MFA_ADMIN. -
Pour les avis Slack, définissez les données d'identification requises et vérifiez que l'intégration Slack est activée dans votre environnement. Les avis Slack ne sont pris en charge que pour les opérations d'authentification multifacteur avec accès SQL.
-
Pour définir les attributs de jeton, vous devez être connecté en tant qu'utilisateur
ADMINou disposer de privilèges sur l'ensembleDBMS_MFA_ADMIN. -
Pour les jetons basés sur une application d'authentification :
-
Installez une application d'authentification prise en charge sur l'appareil mobile que vous voulez enregistrer pour l'authentification multifacteur.
-
Vous devez configurer l'authentification multifacteur à l'aide d'un appareil auquel vous pouvez accéder à chaque connexion. L'authentification multifacteur ne peut pas être activée pour vous par un autre utilisateur.
-
Pour activer l'authentification multifacteur, utilisez l'application d'authentification sur votre appareil mobile pour balayer le code QR généré dans l'interface utilisateur Database Actions. Pour plus d'informations, voir Configuration d'Oracle Mobile Authenticator .
Vous ne pouvez enregistrer qu'un seul appareil mobile pour l'authentification multifacteur.
-
- Pour la transmission par jeton basée sur le courriel, assurez-vous que la transmission par courriel est activée et que les adresses de courriel valides sont configurées pour les utilisateurs de la base de données. Pour plus d'informations, voir Envoyer un courriel sur la base de données autonome d'IA.
- Pour la livraison de jeton basée sur Slack, configurez le plugiciel Slack et enregistrez l'ID Slack de l'utilisateur pour la livraison de mot de passe à usage unique. Pour plus d'informations, voir Envoyer des avis Slack à partir d'une base de données autonome sur l'IA.
-
Rubrique parent : Sommaire des sous-programmes DBMS_MFA_ADMIN
DEREGISTER_USER Procédure
La procédure DBMS_MFA_ADMIN.DEREGISTER_USER supprime un utilisateur de base de données actuellement inscrit pour l'authentification multifacteur. Une fois l'utilisateur supprimé, l'authentification multifacteur n'est plus appliquée pour ce compte et l'utilisateur peut s'authentifier sans second facteur.
Syntaxe
PROCEDURE DBMS_MFA_ADMIN.DEREGISTER_USER (
username IN VARCHAR2,
type IN VARCHAR2,
email IN VARCHAR2 DEFAULT NULL
);Paramètres
| Paramètre | Description |
|---|---|
|
|
Indique le nom d'utilisateur pour lequel l'authentification multifacteur doit être supprimée. |
type |
Spécifie l'attribut d'authentification multifacteur qui contrôle le moment où l'authentification multifacteur est appliquée pour l'utilisateur. Les valeurs valides sont :
|
email |
Spécifie l'adresse de courriel associée à l'utilisateur pour l'authentification multifacteur. Ce paramètre est facultatif et prend par défaut la valeur |
Exemples
BEGIN
DBMS_MFA_ADMIN.DEREGISTER_USER(
username => 'SCOTT',
type => 'SQL ACCESS',
email => 'scott@example.com'
);
END;
/Cet exemple annule l'enregistrement de l'utilisateur SCOTT de l'authentification multifacteur pour l'élément type (SQL ACCESS) spécifié et supprime l'identité de courriel associée (scott@example.com) de la configuration de l'authentification multifacteur.
Note d'utilisation
-
Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur
ADMINou disposer de privilèges sur l'ensembleDBMS_MFA_ADMIN. - Si un utilisateur est enregistré avec plusieurs adresses de courriel, annulez l'enregistrement de chaque adresse de courriel individuellement.
Rubrique parent : Sommaire des sous-programmes DBMS_MFA_ADMIN