

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Autenticación de IAM para OpenSearch UI

En este tema se describen los permisos mínimos de IAM necesarios para acceder a un OpenSearch Aplicación de interfaz de usuario que usa la autenticación de IAM, sin AWS IAM Identity Center. Tras completar estos pasos, un rol de IAM puede iniciar sesión en la aplicación y consultar sus fuentes de datos.

## Requisitos previos
<a name="application-auth-iam-prerequisites"></a>
+ Un OpenSearch Aplicación de interfaz de usuario creada con autenticación de IAM. Para obtener instrucciones sobre cómo crear una aplicación, consulte [Empezando con el OpenSearch interfaz de usuario en Amazon OpenSearch Servicio](application-getting-started.md).
+ Una función de IAM que necesita acceder a la aplicación.
+ El AWS CLI configurado con credenciales.

## Paso 1: conceder el permiso de IAM
<a name="application-auth-iam-grant"></a>

La siguiente política de IAM otorga acceso a la interfaz de la aplicación. Adjúntelo al rol de IAM al que necesite acceso y sustituya los valores del marcador de posición por su propia información:

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "opensearch:ApplicationAccessAll",
            "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}"
        }
    ]
}
```

Al asignar el ámbito del recurso a un único identificador de aplicación, se otorga el menor privilegio que necesita el rol. En su lugar, para conceder acceso a todas las aplicaciones de la cuenta y la región, utiliza un comodín:

```
"Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*"
```

Puedes adjuntar la misma política a la AWS CLI:

```
aws iam put-role-policy \
    --role-name {{role-name}} \
    --policy-name OpenSearchAppAccess \
    --policy-document '{
      "Version":"2012-10-17",
      "Statement":[{
        "Effect":"Allow",
        "Action":"opensearch:ApplicationAccessAll",
        "Resource":"arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}"
      }]
    }'
```

**nota**  
La acción que otorga acceso a la interfaz de la aplicación es `opensearch:ApplicationAccessAll`. Para obtener más información sobre los permisos que requiere una aplicación, consulte [Referencia de políticas de IAM para OpenSearch UI](application-iam-policy-reference.md).

Si sus usuarios también abren la aplicación desde Consola de administración de AWS, añada la siguiente instrucción para que puedan ver la aplicación en la consola:

```
{
    "Effect": "Allow",
    "Action": "es:GetApplication",
    "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}"
}
```

## Paso 2: Configurar el administrador del panel
<a name="application-auth-iam-admin"></a>

Defina qué directores de IAM reciben privilegios de administrador OpenSearch UI. Para conceder privilegios de administrador a todos los usuarios autenticados, ejecute el siguiente comando:

```
aws opensearch update-application \
    --id {{application-id}} \
    --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"*"}]' \
    --region {{region}}
```

Para conceder privilegios de administrador a un único rol, especifique el ARN del rol:

```
aws opensearch update-application \
    --id {{application-id}} \
    --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"arn:aws:iam::{{account-id}}:role/{{role-name}}"}]' \
    --region {{region}}
```

**nota**  
La configuración del administrador del panel controla las funciones del administrador dentro de la interfaz, como la administración de patrones de índices y los objetos guardados. No lo necesita para iniciar sesión: la política de IAM del paso 1 es suficiente para acceder a la aplicación.

## Paso 3: Verificar el acceso
<a name="application-auth-iam-verify"></a>

Puedes verificar el acceso desde un navegador con una URL prefirmada o mediante programación con los encabezados de solicitud de Signature Version 4.

### Verifica el acceso desde un navegador
<a name="application-auth-iam-verify-browser"></a>

El siguiente ejemplo de código de Python genera una URL prefirmada de la versión 4 de Signature que se abre en un navegador:

```
from botocore.session import Session
from botocore.auth import SigV4QueryAuth
from botocore.awsrequest import AWSRequest

session = Session()
cred = session.get_credentials().get_frozen_credentials()

endpoint = "{{application-endpoint}}"
region = "{{region}}"

url = f"https://{endpoint}/_login/"
request = AWSRequest(method="GET", url=url)
SigV4QueryAuth(cred, "opensearch", region, expires=300).add_auth(request)

print(request.url)  # Open this URL in a browser
```

**nota**  
El `/_login/` La URL prefirmada solo funciona en un navegador. No funciona con `curl` u otros clientes HTTP.

### Verifique el acceso mediante programación
<a name="application-auth-iam-verify-programmatic"></a>

En el siguiente ejemplo de código de Python, se firma una solicitud dirigida al punto final de la aplicación con los encabezados de la versión 4 de Signature:

```
from botocore.session import Session
from botocore.auth import SigV4Auth
from botocore.awsrequest import AWSRequest
import subprocess

session = Session()
cred = session.get_credentials().get_frozen_credentials()

endpoint = "{{application-endpoint}}"
region = "{{region}}"

url = f"https://{endpoint}/"
request = AWSRequest(method="GET", url=url)
SigV4Auth(cred, "opensearch", region).add_auth(request)

cmd = ["curl", "-s", "-w", "\nHTTP: %{http_code}\n", "-D", "-"]
for k, v in request.headers.items():
    cmd.extend(["-H", f"{k}: {v}"])
cmd.append(url)

result = subprocess.run(cmd, capture_output=True, text=True)
print(result.stdout)
```

Si la solicitud se realiza correctamente, se devuelve `HTTP/1.1 302 Found` con un `location` encabezado de `/app/workspace_initial`. Una solicitud que devuelve `HTTP/1.1 403 Forbidden` indica un problema con la política de IAM.

## Detalles de firma de Signature Version 4
<a name="application-auth-iam-sigv4"></a>

En la siguiente tabla se enumeran los parámetros de Signature Version 4 que OpenSearch La interfaz de usuario espera.


| Parámetro | Valor | 
| --- | --- | 
| Nombre del servicio | opensearch | 
| Algoritmo | AWS4-HMAC-SHA256 | 
| Encabezados firmados | host, como mínimo | 
| Caducidad de la URL prefirmada | Se recomienda no más de 300 segundos | 

**importante**  
El nombre del servicio Signature Version 4 es `opensearch`. Firmando con `es` o `aoss` hace que la solicitud falle.

## Resumen de la configuración
<a name="application-auth-iam-summary"></a>

En la siguiente tabla se muestra lo que controla cada capa de configuración.


| Capa | Configuración | ¿Es necesario iniciar sesión? | 
| --- | --- | --- | 
| Política de IAM | opensearch:ApplicationAccessAll en el ARN de la aplicación | Sí | 
| Política de IAM | es:GetApplication en la aplicación ARN | Solo para abrir la aplicación desde el Consola de administración de AWS | 
| Configuración de aplicaciones | opensearchDashboards.dashboardAdmin.users | No, solo controla las funciones del administrador | 

## Solución de problemas de autenticación de IAM
<a name="application-auth-iam-troubleshooting"></a>

Los problemas de autenticación de IAM suelen deberse a la falta de una acción política, a una URL prefirmada que se utiliza fuera de un navegador o a una solicitud firmada con un nombre de servicio incorrecto. En la siguiente tabla se enumeran los síntomas comunes, sus causas probables y cómo resolver cada uno de ellos.


| Síntoma | Causa probable | Resolución | 
| --- | --- | --- | 
| 403 Forbidden al abrir la URL de la aplicación | El opensearch:ApplicationAccessAll falta el permiso | Agregue la política de IAM desde el paso 1 | 
| 403 con un mensaje que indique que no está autorizado a actuar es:GetApplication | Falta el permiso de la consola | Agregar es:GetApplication en el ARN de la aplicación. Esto solo es necesario para Consola de administración de AWS acceso | 
| 400 Bad Request en /\_login/ con curl | El /\_login/ el punto final solo funciona en un navegador | Utilice la autenticación de encabezados de la versión 4 de Signature en / para el acceso programático | 
| La URL prefirmada devuelve SignatureDoesNotMatch | El nombre del servicio Signature Version 4 es incorrecto | Firme la solicitud con opensearch, no es o aoss | 
| Puede abrir la aplicación pero faltan las funciones de administrador | El administrador del panel no está configurado | Ejecute update-application con opensearchDashboards.dashboardAdmin.users, como se describe en el paso 2 | 
| La URL prefirmada ha caducado | La URL se generó más de 300 segundos antes | Genera una nueva URL prefirmada. Las URL prefirmadas son de corta duración | 

Para obtener más información sobre las acciones de IAM OpenSearch Usos de la interfaz de usuario, consulte [Referencia de políticas de IAM para OpenSearch UI](application-iam-policy-reference.md).