View a markdown version of this page

Uso de JSON - Amazon Kendra

Amazon Kendra dejará de estar abierto a nuevos clientes a partir del 30 de julio de 2026. Si desea utilizar el servicio, inscríbase antes del 30 de julio. Para obtener capacidades similares a Amazon Kendra, explore las bases de conocimiento de Amazon Bedrock. Más información.

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.

Uso de JSON

Los siguientes ejemplos muestran cómo usar JASON para el control de acceso de los usuarios al crear un índice.

aviso

El token JSON es una carga no validada. Solo debe usarse cuando las solicitudes a Amazon Kendra provienen de un servidor de confianza y nunca de un navegador.

Console

  1. Elija Crear índice para empezar a crear un índice nuevo.

  2. En la página Especificar detalles de índice, proporcione a su índice un nombre y una descripción.

  3. Para el rol de IAM, seleccione un rol o seleccione Crear un nuevo rol y especifique un nombre para crear un nuevo rol. El rol de IAM tendrá el prefijo “AmazonKendra-”.

  4. No cambie los demás valores predeterminados. Elija Siguiente.

  5. En la página Configurar el control de acceso de los usuarios, en Configuración de control de acceso, seleccione Sí para utilizar los tokens para el control de acceso.

  6. En Configuración de token, seleccione JSON como Tipo de token.

  7. Especifique un Nombre de usuario para usarlo en la verificación de la ACL.

  8. Especifique uno o más Grupos para usarlos en la verificación de la ACL.

  9. Elija Siguiente.

  10. En la página Detalles de aprovisionamiento, elija la Edición para desarrolladores.

  11. Elija Crear para crear el índice.

  12. Espere a que se cree el índice. Amazon Kendra aprovisiona el hardware para su índice. Esta operación puede llevar algún tiempo.

CLI

Para crear un índice con la AWS CLI utilizando un archivo de entrada JSON, cree primero un archivo JSON con los parámetros que desee:

{
    "Name": "user-context",
    "Edition": "ENTERPRISE_EDITION",
    "RoleArn": "arn:aws:iam::account-id:role:/my-role",
    "UserTokenConfigurations": [
        {
            "JsonTokenTypeConfiguration": {
                "UserNameAttributeField": "user",
                "GroupAttributeField": "group"
            }
        }
    ],
    "UserContextPolicy": "USER_TOKEN"
}

A continuación, llame a create-index usando el archivo de entrada. Por ejemplo, si el nombre de su archivo JSON es create-index-openid.json, puede usar lo siguiente: 

aws kendra create-index --cli-input-json file://create-index-openid.json

Si no utiliza Open ID para AWS IAM Identity Center, puede enviarnos el token en formato JSON. Si lo hace, debe especificar qué campo del token JSON contiene el nombre de usuario y qué campo contiene los grupos. Los valores del campo de los grupos deben ser una matriz de cadenas JSON. Por ejemplo, si utiliza SAML, su token debería ser similar al siguiente:

{
     "username" : "user1", 
     "groups": [
        "group1", 
        "group2"
     ]
}

La TokenConfiguration especificaría el nombre de usuario y los nombres del campo de los grupos:

{
    "UserNameAttributeField":"username",
    "GroupAttributeField":"groups"
}
Python
response = kendra.create_index(
    Name='user-context',
    Edition='ENTERPRISE_EDITION',
    RoleArn='arn:aws:iam::account-id:role:/my-role',
    UserTokenConfigurations=[
        {
            "JwtTokenTypeConfiguration": {
                "UserNameAttributeField": "user",
                "GroupAttributeField": "group",
            }
        }
    ],
    UserContextPolicy='USER_TOKEN'
)