Pacchetto DBMS_MFA_ADMIN
Il pacchetto DBMS_MFA_ADMIN facilita e configura l'accesso token SQL.
- Riepilogo dei sottoprogrammi DBMS_MFA_ADMIN
Riepilogo dei sottoprogrammi inclusi nel pacchettoDBMS_MFA_ADMIN.
Argomento padre: Riferimento del pacchetto fornito dal database AI autonomo
Riepilogo dei sottoprogrammi DBMS_MFA_ADMIN
Riepiloga i sottoprogrammi inclusi nel pacchetto DBMS_MFA_ADMIN.
- REGISTER_USER Procedura
La proceduraDBMS_MFA_ADMIN.REGISTER_USERregistra un utente di database esistente per l'autenticazione MFA associando l'utente a un indirizzo e-mail come identità esterna. È possibile abilitare MFA per l'autenticazione di accesso, l'accesso SQL o entrambi. Supporta applicazioni di posta elettronica, Slack e autenticatore per fornire token di accesso sicuri. - SET_GLOBAL_TOKEN_ATTRIBUTES Procedura
La proceduraDBMS_MFA_ADMIN.SET_GLOBAL_TOKEN_ATTRIBUTESimposta o aggiorna gli attributi MFA del token di accesso SQL a livello globale per tutti gli utenti registrati. - SET_ATTRIBUTE Procedura
Il fileDBMS_MFA_ADMIN.SET_ATTRIBUTEimposta o aggiorna un singolo attributo MFA per un utente registrato e sostituisce qualsiasi valore predefinito globale applicabile per tale attributo. - SET_ATTRIBUTES Procedura
La proceduraDBMS_MFA_ADMIN.SET_ATTRIBUTESimposta o aggiorna uno o più attributi MFA per un utente registrato e sostituisce tutti i valori predefiniti globali applicabili per tali attributi. - CONFIGURE_NOTIFICATION Procedura
La proceduraDBMS_MFA_ADMIN.CONFIGURE_NOTIFICATIONconfigura i canali attraverso i quali i token MFA vengono inviati agli utenti registrati. Ciò include la definizione del metodo di consegna e delle proprietà specifiche del canale richieste per la distribuzione del token. - DEREGISTER_USER Procedura
La proceduraDBMS_MFA_ADMIN.DEREGISTER_USERrimuove un utente del database attualmente registrato per l'autenticazione MFA. Dopo la rimozione dell'utente, l'autenticazione MFA non viene più applicata per tale account e l'utente può eseguire l'autenticazione senza un secondo fattore.
Argomento padre: Pacchetto DBMS_MFA_ADMIN
Procedura REGISTER_USER
La procedura DBMS_MFA_ADMIN.REGISTER_USER registra un utente di database esistente per l'autenticazione MFA associando l'utente a un indirizzo e-mail come identità esterna. È possibile abilitare MFA per l'autenticazione di accesso, l'accesso SQL o entrambi. Supporta applicazioni di posta elettronica, Slack e autenticatore per fornire token di accesso sicuri.
Sintassi
DBMS_MFA_ADMIN.REGISTER_USER (
username IN VARCHAR2,
type IN VARCHAR2,
email IN CLOB DEFAULT NULL,
attributes IN CLOB DEFAULT NULL
);
Parametri
| Parametro | Descrizione |
|---|---|
|
|
Specifica il nome utente per il quale deve essere applicata l'autenticazione a più fattori. |
|
|
Specifica l'attributo MFA che controlla quando viene applicata l'autenticazione MFA per l'utente. type accetta i seguenti valori:
|
|
|
Specifica l'indirizzo e-mail da associare all'utente per l'autenticazione MFA. |
|
|
Specifica gli attributi MFA in formato JSON. Utilizzare
|
Esempi
Esempio di registrazione di un utente per il collegamento MFA:
BEGIN
DBMS_MFA_ADMIN.REGISTER_USER(
user_name => 'SCOTT',
type => 'LOGON',
email => 'scott@example.com',
token_attributes => '{"auth_method":"oma_push"}'
);
END;
/
Esempio per registrare un utente per l'accesso SQL impostando gli attributi MFA.
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;
/
Note sull'uso
-
Per registrare un utente, è necessario aver eseguito il login come utente
ADMINo disporre dei privilegi per il pacchettoDBMS_MFA_ADMIN. -
È possibile registrare gli utenti del database per l'autenticazione MFA utilizzando provider diversi a seconda del tipo MFA: Duo e OMA sono supportati per l'autenticazione MFA in fase di login, mentre Slack, OMA ed e-mail sono supportati per l'autenticazione MFA del token di accesso SQL.
-
È possibile registrare lo stesso utente per entrambi i tipi MFA (accesso MFA e accesso SQL) registrandoli separatamente per ciascuno. È possibile utilizzare lo stesso indirizzo e-mail o un indirizzo diverso per ogni registrazione; una volta configurato, l'utente riceve una notifica push all'indirizzo e-mail registrato all'accesso e un'altra notifica, allo stesso indirizzo, se utilizzato, quando l'utente esegue
INITIALIZE_SESSIONper SQL Access.
Argomento padre: Riepilogo dei sottoprogrammi DBMS_MFA_ADMIN
Procedura SET_GLOBAL_TOKEN_ATTRIBUTES
La procedura DBMS_MFA_ADMIN.SET_GLOBAL_TOKEN_ATTRIBUTES imposta o aggiorna gli attributi MFA del token di accesso SQL a livello globale per tutti gli utenti registrati.
Sintassi
DBMS_MFA_ADMIN.SET_GLOBAL_TOKEN_ATTRIBUTES(
attributes IN VARCHAR2
);Parametri
| Parametro | Descrizione |
|---|---|
|
|
Specifica gli attributi del token in formato JSON per generare un token di accesso. I valori validi sono i seguenti:
|
Nota per l'uso
-
Per impostare gli attributi del token, è necessario aver eseguito il login come utente
ADMINo disporre dei privilegi per il pacchettoDBMS_MFA_ADMIN.
Argomento padre: Riepilogo dei sottoprogrammi DBMS_MFA_ADMIN
Procedura SET_ATTRIBUTE
DBMS_MFA_ADMIN.SET_ATTRIBUTE imposta o aggiorna un singolo attributo MFA per un utente registrato e sostituisce qualsiasi valore predefinito globale applicabile per tale attributo.
Per l'ora di login MFA,
auth_method è l'unico attributo supportato.
Sintassi
DBMS_MFA_ADMIN.SET_ATTRIBUTE(
username IN VARCHAR2,
type IN VARCHAR2,
email IN VARCHAR2 DEFAULT NULL,
attribute_name IN VARCHAR2,
attribute_value IN CLOB
);Parametri
| Parametro | Descrizione |
|---|---|
|
|
Specifica l'utente del database il cui attributo MFA deve essere aggiornato. |
|
|
Specifica l'attributo MFA che controlla quando viene applicata l'autenticazione MFA per l'utente. I valori validi sono i seguenti:
|
|
|
Specifica l'indirizzo e-mail da associare all'utente per l'autenticazione MFA. Questo parametro è facoltativo e il valore predefinito è |
|
|
Specifica il nome dell'attributo MFA da aggiornare. I valori validi sono i seguenti:
|
|
|
Il nuovo valore dell'attributo specificato. |
Esempio
SCOTT:BEGIN
DBMS_MFA_ADMIN.SET_ATTRIBUTE(
username => 'scott',
type => 'sql access',
email => 'testscott@example.com',
attribute_name => 'duration_min',
attribute_value => '20');
END;
/Note sull'uso
-
Il parametro
usernamedeve specificare un utente di database esistente registrato per MFA. -
Per eseguire questa procedura, è necessario aver eseguito il login come utente
ADMINo disporre dei privilegi per il pacchettoDBMS_MFA_ADMIN.
Argomento padre: Riepilogo dei sottoprogrammi DBMS_MFA_ADMIN
Procedura SET_ATTRIBUTES
La procedura DBMS_MFA_ADMIN.SET_ATTRIBUTES imposta o aggiorna uno o più attributi MFA per un utente registrato e sostituisce tutti i valori predefiniti globali applicabili per tali attributi.
Per l'ora di login MFA,
auth_method è l'unico attributo supportato.
Sintassi
DBMS_MFA_ADMIN.SET_ATTRIBUTES (
username IN VARCHAR2,
type IN VARCHAR2,
attributes IN CLOB
);
Parametri
| Parametro | Descrizione |
|---|---|
|
|
Specifica il nome utente i cui attributi MFA devono essere aggiornati. |
|
|
Specifica l'attributo MFA che controlla quando viene applicata l'autenticazione MFA per l'utente. I valori validi sono i seguenti:
|
attributes |
Specifica gli attributi MFA in formato JSON. I valori validi sono i seguenti:
|
Esempio
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;
/Note sull'uso
-
Il parametro
USERNAMEdeve specificare un utente di database esistente registrato per MFA. -
Per eseguire questa procedura, è necessario aver eseguito il login come utente
ADMINo disporre dei privilegi per il pacchettoDBMS_MFA_ADMIN.
Argomento padre: Riepilogo dei sottoprogrammi DBMS_MFA_ADMIN
Procedura CONFIGURE_NOTIFICATION
La procedura DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION configura i canali attraverso i quali i token MFA vengono inviati agli utenti registrati. Ciò include la definizione del metodo di consegna e delle proprietà specifiche del canale richieste per la distribuzione del token.
Sintassi
DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION (
notification_type IN VARCHAR2,
attributes IN CLOB
);
Parametri
| Parametro | Descrizione |
|---|---|
|
|
Specifica il tipo di canale di notifica da configurare. I valori validi sono: |
|
|
Fornisce i dettagli di configurazione per il canale di notifica specificato in formato JSON. Di seguito sono riportati i tipi di attributo validi per ciascun canale di notifica. EMAIL: obbligatorio per l'impostazione del collegamento MFA; OTP via e-mail supportato solo per l'autenticazione MFA del token di accesso SQL
SLACK: supportato solo per MFA token di eccesso SQL
OMA: supportato sia per l'autenticazione MFA del token di accesso che per l'integrazione SQL
DUO: supportato solo per MFA di accesso:
|
Esempi
Esempio: configurazione del canale di notifica 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;
/
Esempio: configurazione del canale di notifica Slack
BEGIN
DBMS_MFA_ADMIN.CONFIGURE_NOTIFICATION(
notification_type => 'SLACK',
attributes => JSON_OBJECT('credential_name' VALUE 'SLACK_CRED')
);
END;
/Esempio: configurazione del canale di notifica 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;
/
Esempio: configurazione del canale di notifica 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;
/Note sull'uso
-
Per eseguire questa procedura, è necessario aver eseguito il login come utente
ADMINo disporre dei privilegi necessari per il pacchettoDBMS_MFA_ADMIN. -
Per le notifiche Slack, impostare le credenziali richieste e confermare che l'integrazione Slack è abilitata nell'ambiente in uso. Le notifiche Slack sono supportate solo per le operazioni MFA di accesso SQL.
-
Per impostare gli attributi del token, è necessario aver eseguito il login come utente
ADMINo disporre dei privilegi per il pacchettoDBMS_MFA_ADMIN. -
Per i token basati sull'applicazione Authenticator:
-
Installare un'app di autenticazione supportata sul dispositivo mobile che si intende registrare per l'autenticazione MFA.
-
È necessario impostare l'autenticazione MFA utilizzando un dispositivo a cui è possibile accedere ogni volta che si esegue l'accesso. L'autenticazione MFA non può essere abilitata per conto dell'utente da un altro utente.
-
Per abilitare l'autenticazione MFA, utilizzare l'applicazione di autenticazione sul dispositivo mobile per eseguire la scansione del codice QR generato nell'interfaccia utente di Database Actions. Per ulteriori informazioni, vedere Configurazione di Oracle Mobile Authenticator.
È possibile registrare un solo dispositivo mobile per MFA.
-
- Per la consegna dei token basata su e-mail, assicurarsi che la consegna delle e-mail sia abilitata e che gli indirizzi e-mail validi siano configurati per gli utenti del database. Per ulteriori informazioni, vedere Invia e-mail su Autonomous AI Database.
- Per la consegna del token basato su Slack, configurare il plugin Slack e registrare l'ID Slack dell'utente per la consegna OTP. Per ulteriori informazioni, consulta la sezione Invia notifiche Slack da Autonomous AI Database.
-
Argomento padre: Riepilogo dei sottoprogrammi DBMS_MFA_ADMIN
Procedura DEREGISTER_USER
La procedura DBMS_MFA_ADMIN.DEREGISTER_USER rimuove un utente del database attualmente registrato per l'autenticazione MFA. Dopo la rimozione dell'utente, l'autenticazione MFA non viene più applicata per tale account e l'utente può eseguire l'autenticazione senza un secondo fattore.
Sintassi
PROCEDURE DBMS_MFA_ADMIN.DEREGISTER_USER (
username IN VARCHAR2,
type IN VARCHAR2,
email IN VARCHAR2 DEFAULT NULL
);Parametri
| Parametro | Descrizione |
|---|---|
|
|
Specifica il nome utente per il quale deve essere rimossa l'autenticazione a più fattori. |
type |
Specifica l'attributo MFA che controlla quando viene applicata l'autenticazione MFA per l'utente. I valori validi sono i seguenti:
|
email |
Specifica l'indirizzo e-mail associato all'utente per l'autenticazione MFA. Questo parametro è facoltativo e il valore predefinito è |
Esempi
BEGIN
DBMS_MFA_ADMIN.DEREGISTER_USER(
username => 'SCOTT',
type => 'SQL ACCESS',
email => 'scott@example.com'
);
END;
/Questo esempio annulla la registrazione dell'utente SCOTT da MFA per il file type (SQL ACCESS) specificato e rimuove l'identità di posta elettronica associata (scott@example.com) dalla configurazione MFA.
Nota per l'uso
-
Per eseguire questa procedura, è necessario aver eseguito il login come utente
ADMINo disporre dei privilegi necessari per il pacchettoDBMS_MFA_ADMIN. - Se un utente è registrato con più indirizzi e-mail, annullare la registrazione di ciascun indirizzo e-mail singolarmente.
Argomento padre: Riepilogo dei sottoprogrammi DBMS_MFA_ADMIN