# Perfil de IAM
<a name="odbc-v2-driver-iam-profile"></a>

Puede configurar un perfil con nombre para conectarse a Amazon Athena mediante el controlador ODBC. Puede usar un perfil con nombre asignado con uno de las siguientes orígenes de credenciales:
+ `Ec2InstanceMetadata` – Recupera los credenciales del Servicio de metadatos de instancias (IMDS) de Amazon EC2. Utilícelo al ejecutar una instancia de Amazon EC2.
+ `EcsContainer` – Recupera las credenciales del punto de conexión del rol de ejecución de tareas de Amazon ECS. Útilícelo cuando se ejecute en un contenedor Amazon ECS.
+ `Environment` – Recupera las credenciales de las variables de entorno (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`).

Establezca el parámetro `credential_source` en su configuración de perfil AWS en el valor adecuado para su entorno. Si desea utilizar un proveedor de credenciales personalizado en un perfil con nombre, especifique un valor para el parámetro `plugin_name` en la configuración de su perfil.

## Tipo de autenticación
<a name="odbc-v2-driver-iam-profile-authentication-type"></a>


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| AuthenticationType | Obligatorio | IAM Credentials | AuthenticationType=IAM Profile; | 

## AWSPerfil de
<a name="odbc-v2-driver-iam-profile-aws-profile"></a>

El nombre del perfil que se va a utilizar para la conexión ODBC. Para obtener más información sobre los perfiles, consulte [Uso de perfiles con nombre](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-using-profiles) en la *Guía del usuario de AWS Command Line Interface*.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| Perfil de AWS | Obligatorio | none | AWSProfile=default; | 

## Rol preferido
<a name="odbc-v2-driver-iam-profile-preferred-role"></a>

El nombre de recurso de Amazon (ARN) del rol que se asignará. El parámetro de rol preferido se usa cuando el parámetro `plugin_name` especifica el proveedor de credenciales personalizado en la configuración del perfil. Para obtener más información sobre los roles de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*. 


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| preferred\$1role | Opcional | none | preferred\$1role=arn:aws:IAM::123456789012:id/user1; | 

## Duración de la sesión
<a name="odbc-v2-driver-iam-profile-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información sobre la duración de la sesión, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*. El parámetro de duración de la sesión se usa cuando el parámetro `plugin_name` especifica el proveedor de credenciales personalizado en la configuración del perfil.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| duración | Opcional | 900 | duration=900; | 

## Nombre del complemento
<a name="odbc-v2-driver-iam-profile-plugin-name"></a>

Especifica el nombre de un proveedor de credenciales personalizado utilizado en un perfil con nombre. Este parámetro puede tomar los mismos valores que los del campo **Tipo de autenticación** del administrador de orígenes de datos ODBC, pero solo se usa en la configuración `AWSProfile`.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| plugin\$1name | Opcional | none | plugin\$1name=AzureAD; |