Uso de la entidad de recurso para acceder a los recursos de Oracle Cloud Infrastructure

Puede utilizar una entidad de recurso para autenticar y acceder a los recursos de Oracle Cloud Infrastructure.

Una entidad de recurso consta de un token de sesión temporal y credenciales seguras que permiten que la base de datos se autentique en otros servicios de Oracle Cloud Infrastructure. Mediante una entidad de recurso para acceder a los servicios, el token almacenado con las credenciales en la base de datos de IA autónoma solo es válido para los recursos a los que se ha otorgado acceso al grupo dinámico.

Para utilizar la entidad de recurso, usted o el administrador de su arrendamiento definen las políticas de Oracle Cloud Infrastructure y un grupo dinámico que le permite acceder a los recursos de Oracle Cloud Infrastructure con una entidad de recurso. No es necesario que cree un objeto de credencial y Autonomous AI Database crea y protege las credenciales de entidad de recurso que utiliza para acceder a los recursos de Oracle Cloud Infrastructure especificados.

Por ejemplo, al utilizar Autonomous AI Database, puede que desee utilizar los recursos de Oracle Cloud Infrastructure para hacer lo siguiente:

• Acceder a los datos de un cubo de almacenamiento de objetos y realizar alguna operación en los datos y, a continuación, volver a escribir los datos modificados.

• Acceda a sus almacenes, claves o secretos.

• Lista de solicitudes de trabajo o lista de errores de solicitudes de trabajo.

Al trabajar con la base de datos, autenticará y accederá a la base de datos como usuario de base de datos. Un usuario de base de datos de IA autónoma no tiene una identidad de Oracle Cloud Infrastructure Identity and Access Management (IAM), por lo que, como usuario de base de datos de IA autónoma, no puede utilizar sus credenciales de base de datos para acceder a los servicios de Oracle Cloud Infrastructure. Sin una entidad de recurso, debe obtener credenciales para acceder a los recursos de Oracle Cloud Infrastructure y crear un objeto de credencial para acceder a un recurso desde la base de datos de IA autónoma.

Una entidad de recurso permite que los recursos estén autorizados para realizar acciones en los servicios de Oracle Cloud Infrastructure. Cada recurso tiene su propia identidad y se autentica mediante los certificados que se le agregan. Estos certificados se crean, asignan a los recursos y rotan automáticamente, evitando la necesidad de que cree y gestione sus propias credenciales para acceder al recurso.

Autonomous AI Database le permite utilizar una entidad de recurso para autenticarse en las API de Oracle Cloud Infrastructure mediante las siguientes interfaces:

• Procedimientos y funciones DBMS_CLOUD que toman un argumento de credencial
• API del SDK PL/SQL de Oracle Cloud Infrastructure

Al autenticarse mediante una entidad de recurso, la base de datos de IA autónoma proporciona un método seguro para acceder a los recursos de Oracle Cloud Infrastructure.

Hay varios pasos necesarios para configurar una entidad de recurso en la base de datos de IA autónoma:

• Debe crear una definición de políticas de Oracle Cloud Infrastructure Infrastructure Identity and Access Management (IAM). Consulte Realización de requisitos previos para utilizar la entidad de recurso con una base de datos de IA autónoma para obtener más información.

• Debe activar la entidad de recurso para el usuario ADMIN y, opcionalmente, activar la entidad de recurso para un usuario de la base. Consulte Activación de la entidad de recurso para acceder a recursos de Oracle Cloud Infrastructure para obtener más información.

Al autenticarse mediante una entidad de recurso, no necesita crear ni gestionar credenciales para acceder a los recursos de Oracle Cloud Infrastructure. La base de datos de IA autónoma pone a su disposición la entidad de recurso y la protege.

Antes de realizar una llamada a un recurso de Oracle Cloud Infrastructure mediante una entidad de recurso, un administrador de arrendamiento de Oracle Cloud Infrastructure debe crear políticas, grupos dinámicos y reglas de Oracle Cloud Infrastructure que definan los privilegios de entidad de recurso.

1. Cree un grupo dinámico de Oracle Cloud Infrastructure.
   1. En la consola de Oracle Cloud Infrastructure, haga clic en Identidad y seguridad y a continuación en Grupos dinámicos
   2. Haga clic en Crear grupo dinámico e introduzca un nombre, una descripción y una regla, o bien utilice el creador de reglas para agregar una regla.
   3. Haga clic en Crear.

   Los recursos que cumplen los criterios de las reglas son miembros del grupo dinámico. Al definir una regla para un grupo dinámico, considere qué recurso se va a otorgar acceso a otros recursos.

   Por ejemplo, tenga en cuenta los siguientes ejemplos:

   • Permitir que una instancia de base de datos de IA autónoma específica acceda a un recurso.

     La base de datos de IA autónoma se especifica en el parámetro resource.id con un OCID:

     resource.id = 'your_Autonomous_Database_instance_OCID'

     Debe agregar un nombre de dominio cuando el arrendamiento utilice un dominio de identidad. Por ejemplo:

     resource.id = 'identity_domain_name/your_Autonomous_Database_instance_OCID'

   • Permitir todas las bases de datos de IA autónomas en un compartimento.

     Las bases de datos de IA autónomas se especifican en el parámetro resource.type y el compartimento se identifica mediante un OCID especificado en el parámetro resource.compartment.id:

     ALL {resource.type = 'autonomousdatabase', resource.compartment.id = 'your_Compartment_OCID'}

   • Permitir que todos los recursos del compartimento

     Tipo de recurso identificado por el OCID, especificado en el parámetro resource.compartment.id:

     ALL
             {resource.compartment.id='your_Compartment_OCID'}

   Consulte Gestión de grupos dinámicos para obtener más información sobre la creación de un grupo dinámico y la creación de reglas para agregar recursos al grupo.

2. Escribir sentencias de política para el grupo dinámico para permitir el acceso a los recursos de Oracle Cloud Infrastructure.
   1. En la consola de Oracle Cloud Infrastructure, haga clic en Identidad y seguridad y, a continuación, en Políticas.
   2. Para escribir políticas para un grupo dinámico, haga clic en Crear directiva e introduzca un nombre y una descripción.
   3. Utilice el Creador de política para crear una política.

      Por ejemplo, para crear una política que permita el acceso al almacén de objetos de Oracle Cloud Infrastructure a fin de gestionar cubos y objetos en el almacén de objetos de un arrendamiento:

      Allow dynamic-group Example5 to manage buckets in tenancy
      Allow dynamic-group Example5 to manage objects in tenancy

      Debe agregar un nombre de dominio cuando el arrendamiento utilice un dominio de identidad. Por ejemplo:

      Allow dynamic-group identity_domain_name/Example5 to manage buckets in tenancy
      Allow dynamic-group identity_domain_name/Example5 to manage objects in tenancy

   4. Haga clic en Crear.

Realice los siguientes pasos para activar la entidad de recurso en la base de datos de IA autónoma.

1. Como usuario ADMIN, active la entidad de recurso para la instancia de base de datos de IA autónoma.

   Por ejemplo:

   EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();
   
   PL/SQL procedure successfully completed. 
   

   Consulte ENABLE_RESOURCE_PRINCIPAL Procedure para obtener más información.

   Esto crea la credencial OCI$RESOURCE_PRINCIPAL.

2. (Opcional) Este paso solo es necesario si desea otorgar acceso a la credencial de entidad de recurso a un usuario de base de datos que no sea el usuario ADMIN. Como usuario ADMIN, active la entidad de recurso para un usuario de base de datos especificado.

   Por ejemplo:

   EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(username => 'adb_user');
   
   PL/SQL procedure successfully completed. 
   

   Esto otorga al usuario acceso adb_user a la credencial OCI$RESOURCE_PRINCIPAL.

   Si desea que el usuario especificado tenga privilegios para activar la entidad de recurso para otros usuarios, defina el parámetro grant_option en TRUE.

   Por ejemplo:

   BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(
        username => 'adb_user',
        grant_option => TRUE);
   END;
   /

   Después de ejecutar este comando, adb_user puede activar la entidad de recurso para otro usuario. Por ejemplo, si se conecta como adb_user, puede ejecutar el siguiente comando:

   EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(username => 'adb_user2');
   

   Consulte ENABLE_RESOURCE_PRINCIPAL Procedure para obtener más información.
3. Verifique que la credencial de entidad de recurso esté activada.

   Por ejemplo, cuando el usuario ADMIN consulta la vista DBA_CREDENTIALS:

   SELECT owner, credential_name FROM dba_credentials 
           WHERE credential_name = 'OCI$RESOURCE_PRINCIPAL' AND owner = 'ADMIN'; 
   
   OWNER  CREDENTIAL_NAME
   -----  ----------------------
   ADMIN  OCI$RESOURCE_PRINCIPAL 
   

   Por ejemplo, como usuario no ADMIN, consulte la vista ALL_TAB_PRIVS:

   SELECT grantee, table_name, grantor FROM ALL_TAB_PRIVS
      WHERE grantee = 'ADB_USER' 
           AND table_name = 'OCI$RESOURCE_PRINCIPAL' 
           AND table_schema = 'ADMIN';
   
   GRANTEE   TABLE_NAME                GRANTOR
   --------- -----------------------   -------------
   ADB_USER  OCI$RESOURCE_PRINCIPAL    ADMIN

Muestra los pasos para desactivar la entidad de recurso para todos los usuarios de la base de datos de IA autónoma o para un usuario especificado.

1. Para desactivar la entidad de recurso para todos los usuarios, como usuario ADMIN, ejecute el siguiente comando:

   EXEC DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL();

   Esto elimina la credencial OCI$RESOURCE_PRINCIPAL.

2. Verifique que la credencial de entidad de recurso esté desactivada.

   Por ejemplo:

   SELECT owner, credential_name FROM dba_credentials 
           WHERE credential_name = 'OCI$RESOURCE_PRINCIPAL' AND owner = 'ADMIN';
   
   No rows selected
   

EXEC DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL(username => 'ADB_USER');

Al especificar credenciales de entidad de recurso con llamadas DBMS_CLOUD, la base de datos autentica las solicitudes de Oracle Cloud Infrastructure y la base de datos proporciona las credenciales para acceder a los recursos de Oracle Cloud Infrastructure.

1. Utilice un procedimiento o función DBMS_CLOUD y especifique OCI$RESOURCE_PRINCIPAL como nombre de credencial.

   Por ejemplo, puede acceder a Oracle Cloud Infrastructure Object Storage mediante una entidad de recurso:

   CREATE TABLE CHANNELS
      (channel_id CHAR(1),
       channel_desc VARCHAR2(20),
       channel_class VARCHAR2(20)
      );
   /
   
   BEGIN
    DBMS_CLOUD.COPY_DATA(
       table_name =>'CHANNELS',
       credential_name =>'OCI$RESOURCE_PRINCIPAL',
       file_uri_list =>'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/channels.txt',
       format => json_object('delimiter' value ',')
    );
   END;
   /