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.
# Identity and Access Management para Amazon Detective
AWS Identity and Access Management (IAM) es una Servicio de AWS que ayuda al administrador a controlar de forma segura el acceso a AWS los recursos. Los administradores de IAM controlan quién puede estar *autenticado* (ha iniciado sesión) y *autorizado* (tiene permisos) para utilizar recursos de Detective. La IAM es una Servicio de AWS herramienta que puede utilizar sin coste adicional.
**Topics**
+ [Público](#security_iam_audience)
+ [Autenticación con identidades](#security_iam_authentication)
+ [Administración de acceso mediante políticas](#security_iam_access-manage)
+ [Cómo funciona Amazon Detective con IAM](security_iam_service-with-iam.md)
+ [Ejemplos de políticas de basadas en identidades de Amazon Detective](security_iam_id-based-policy-examples.md)
+ [AWS políticas gestionadas para Amazon Detective](security-iam-awsmanpol.md)
+ [Usar roles vinculados a servicios para Detective](using-service-linked-roles.md)
+ [Solución de problemas de identidad y acceso de Amazon Detective](security_iam_troubleshoot.md)
## Público
La forma de usar AWS Identity and Access Management (IAM) varía según la función que desempeñes:
+ **Usuario del servicio:** solicite permisos al administrador si no puede acceder a las características (consulte [Solución de problemas de identidad y acceso de Amazon Detective](security_iam_troubleshoot.md)).
+ **Administrador del servicio:** determine el acceso de los usuarios y envíe las solicitudes de permiso (consulte [Cómo funciona Amazon Detective con IAM](security_iam_service-with-iam.md)).
+ **Administrador de IAM**: escribe las políticas para administrar el acceso (consulte [Ejemplos de políticas de basadas en identidades de Amazon Detective](security_iam_id-based-policy-examples.md)).
## Autenticación con identidades
La autenticación es la forma en que inicias sesión AWS con tus credenciales de identidad. Debe autenticarse como usuario de Usuario raíz de la cuenta de AWS IAM o asumir una función de IAM.
Puede iniciar sesión como una identidad federada con las credenciales de una fuente de identidad, como AWS IAM Identity Center (IAM Identity Center), la autenticación de inicio de sesión único o las credenciales. Google/Facebook Para obtener más información sobre el inicio de sesión, consulte [Cómo iniciar sesión en la Cuenta de AWS](https://docs.aws.amazon.com/signin/latest/userguide/how-to-sign-in.html) en la *Guía del usuario de AWS Sign-In *.
Para el acceso programático, AWS proporciona un SDK y una CLI para firmar criptográficamente las solicitudes. Para obtener más información, consulte [AWS Signature Version 4 para solicitudes de API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) en la *Guía del usuario de IAM*.
### Cuenta de AWS usuario root
Al crear un Cuenta de AWS, se comienza con una identidad de inicio de sesión denominada *usuario Cuenta de AWS raíz* que tiene acceso completo a todos Servicios de AWS los recursos. Se recomiendaencarecidamente que no utilice el usuario raíz para las tareas diarias. Para ver la lista completa de las tareas que requieren credenciales de usuario raíz, consulte [Tareas que requieren credenciales de usuario raíz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks) en la *Guía del usuario de IAM*.
### Usuarios y grupos de IAM
Un *[usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html)* es una identidad con permisos específicos para una sola persona o aplicación. Recomendamos el uso de credenciales temporales en lugar de usuarios de IAM con credenciales de larga duración. Para obtener más información, consulte [Exigir a los usuarios humanos que utilicen la federación con un proveedor de identidad para acceder AWS mediante credenciales temporales](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) en la Guía del *usuario de IAM*.
Un [https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html) especifica un conjunto de usuarios de IAM y facilita la administración de los permisos para grupos grandes de usuarios. Para obtener más información, consulte [Casos de uso para usuarios de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/gs-identities-iam-users.html) en la *Guía del usuario de IAM*.
### Roles de IAM
Un *[Rol de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)* es una identidad con permisos específicos que proporciona credenciales temporales. Puede asumir un rol [cambiando de un rol de usuario a uno de IAM (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html) o llamando a una AWS CLI operación de AWS API. Para obtener más información, consulte [Métodos para asumir un rol](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage-assume.html) en la *Guía del usuario de IAM*.
Los roles de IAM son útiles para el acceso de usuario federado, los permisos de usuario de IAM temporales, el acceso entre cuentas, el acceso entre servicios y las aplicaciones que se ejecutan en Amazon EC2. Para obtener más información, consulte [Acceso a recursos entre cuentas en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) en la *Guía del usuario de IAM*.
## Administración de acceso mediante políticas
AWS Para controlar el acceso, puede crear políticas y adjuntarlas a AWS identidades o recursos. Una política define los permisos cuando están asociados a una identidad o un recurso. AWS evalúa estas políticas cuando un director hace una solicitud. La mayoría de las políticas se almacenan AWS como documentos JSON. Para obtener más información sobre los documentos de políticas de JSON, consulte [Información general de políticas de JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#access_policies-json) en la *Guía del usuario de IAM*.
Mediante las políticas, los administradores especifican quién tiene acceso a qué, definiendo qué **entidad principal** puede realizar **acciones** sobre qué **recursos** y en qué **condiciones**.
De forma predeterminada, los usuarios y los roles no tienen permisos. Un administrador de IAM crea políticas de IAM y las agrega a roles, que los usuarios pueden asumir posteriormente. Las políticas de IAM definen permisos independientemente del método que se utilice para realizar la operación.
### Políticas basadas en identidad
Las políticas basadas en identidad son documentos de política de permisos JSON que asocia a una identidad (usuario, grupo o rol). Estas políticas controlan qué acciones pueden realizar las identidades, en qué recursos y en qué condiciones. Para obtener más información sobre cómo crear una política basada en la identidad, consulte [Definición de permisos de IAM personalizados con políticas administradas por el cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) en la *Guía del usuario de IAM*.
Las políticas basadas en identidad pueden ser *políticas insertadas* (incrustadas directamente en una sola identidad) o *políticas administradas* (políticas independientes asociadas a varias identidades). Para obtener información sobre cómo elegir entre políticas administradas e insertadas, consulte [Selección entre políticas administradas y políticas insertadas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-choosing-managed-or-inline.html) en la *Guía del usuario de IAM*.
### Políticas basadas en recursos
Las políticas basadas en recursos son documentos de políticas JSON que se asocian a un recurso. Los ejemplos incluyen las *Políticas de confianza de roles* de IAM y las *Políticas de bucket* de Amazon S3. En los servicios que admiten políticas basadas en recursos, los administradores de servicios pueden utilizarlos para controlar el acceso a un recurso específico. Debe [especificar una entidad principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) en una política basada en recursos.
Las políticas basadas en recursos son políticas insertadas que se encuentran en ese servicio. No puedes usar políticas AWS gestionadas de IAM en una política basada en recursos.
### Listas de control de acceso () ACLs
Las listas de control de acceso (ACLs) controlan qué directores (miembros de la cuenta, usuarios o roles) tienen permisos para acceder a un recurso. ACLs son similares a las políticas basadas en recursos, aunque no utilizan el formato de documento de políticas JSON.
Amazon S3 y Amazon VPC son ejemplos de servicios compatibles. AWS WAF ACLs Para obtener más información ACLs, consulte la [descripción general de la lista de control de acceso (ACL)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html) en la *Guía para desarrolladores de Amazon Simple Storage Service*.
### Otros tipos de políticas
AWS admite tipos de políticas adicionales que pueden establecer los permisos máximos otorgados por los tipos de políticas más comunes:
+ **Límites de permisos:** establecen los permisos máximos que una política basada en identidad puede conceder a una entidad de IAM. Para obtener más información, consulte [Límites de permisos para las entidades de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) en la *Guía del usuario de IAM*.
+ **Políticas de control de servicios (SCPs)**: especifican los permisos máximos para una organización o unidad organizativa en AWS Organizations. Para obtener más información, consulte [Políticas de control de servicios](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) en la *Guía del usuario de AWS Organizations *.
+ **Políticas de control de recursos (RCPs)**: establece los permisos máximos disponibles para los recursos de tus cuentas. Para obtener más información, consulte [Políticas de control de recursos (RCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_rcps.html) en la *Guía del AWS Organizations usuario*.
+ **Políticas de sesión:** políticas avanzadas que se pasan como parámetro cuando se crea una sesión temporal para un rol o un usuario federado. Para obtener más información, consulte [Políticas de sesión](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session) en la *Guía del usuario de IAM*.
### Varios tipos de políticas
Cuando se aplican varios tipos de políticas a una solicitud, los permisos resultantes son más complicados de entender. Para saber cómo se AWS determina si se debe permitir una solicitud cuando se trata de varios tipos de políticas, consulte la [lógica de evaluación de políticas](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) en la *Guía del usuario de IAM*.
# Cómo funciona Amazon Detective con IAM
De forma predeterminada, los usuarios y roles no tienen permiso para crear ni modificar los recursos de Amazon Detective. Tampoco pueden realizar tareas con la Consola de administración de AWS AWS CLI, o la AWS API. Un administrador de Detectives debe tener políticas AWS Identity and Access Management (IAM) que concedan permiso a los usuarios y roles de IAM para realizar operaciones de API específicas en los recursos específicos que necesitan. El administrador debe asociar esas políticas a la entidad principal que necesite esos permisos.
Detective utiliza políticas de IAM basadas en identidades para conceder permisos relacionados con los siguientes tipos de usuarios y acciones:
+ **Cuentas de administrador**: la cuenta de administrador es el propietario de un determinado gráfico de comportamiento, que utiliza los datos de su cuenta. Las cuentas de administrador pueden invitar a cuentas de miembros para que aporten datos al gráfico de comportamiento. La cuenta de administrador también puede usar el gráfico de comportamiento para clasificar e investigar los hallazgos y los recursos asociados a esas cuentas.
Puede configurar políticas para que todos los usuarios, además de las cuentas de administrador, puedan llevar a cabo distintas tareas. Por ejemplo, un usuario de una cuenta de administrador puede tener permisos únicamente para administrar cuentas de miembros. Es posible que otro usuario solo tenga permisos para usar el gráfico de comportamiento con fines de investigación.
+ **Cuentas de miembros**: una cuenta de miembro es una cuenta a la que se le ha invitado a aportar datos a un gráfico de comportamiento. Para ello, la cuenta de miembro debe responder a una invitación. Después de aceptarla, la cuenta de miembro puede eliminar su cuenta del gráfico de comportamiento.
Para obtener una visión general de cómo los Detectives y otras personas Servicios de AWS trabajan con IAM, consulte [Creación de políticas en la pestaña JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) de la Guía del *usuario de IAM*.
## Políticas basadas en identidades de Detective
Con las políticas basadas en identidad de IAM, puede especificar las acciones y recursos permitidos o denegados. Detective admite acciones, claves de condición y recursos específicos.
Para obtener información sobre todos los elementos que utiliza en una política JSON, consulte [Referencia de los elementos de las políticas JSON de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) en la *Guía del usuario de IAM*.
### Acciones
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.
El elemento `Action` de una política JSON describe las acciones que puede utilizar para conceder o denegar el acceso en una política. Incluya acciones en una política para conceder permisos y así llevar a cabo la operación asociada.
Las instrucciones de la política deben incluir un elemento `Action` o `NotAction`. El elemento `Action` enumera las acciones permitidas por la política, mientras que el elemento `NotAction` enumera las no permitidas.
Las acciones definidas para Detective le indican las tareas que puede llevar a cabo con Detective. Las acciones de políticas en Detective tienen el siguiente prefijo: `detective:`.
Por ejemplo, si desea conceder permiso para utilizar la operación de la API `CreateMembers` e invitar cuentas de miembros a un gráfico de comportamiento, debe incluir la acción `detective:CreateMembers` en su política.
Para especificar varias acciones en una única instrucción, sepárelas con comas. Por ejemplo, en el caso de una cuenta de miembro, la política incluye el conjunto de acciones relacionadas con la administración de invitaciones:
```
"Action": [
"detective:ListInvitations",
"detective:AcceptInvitation",
"detective:RejectInvitation",
"detective:DisassociateMembership
]
```
También puede utilizar comodines (\$1) para especificar varias acciones. Por ejemplo, para gestionar los datos utilizados en un gráfico de rendimiento, las cuentas de administrador de Detective deben poder llevar a cabo las siguientes tareas:
+ Consultar la lista de cuentas de miembros (`ListMembers`)
+ Obtener información sobre determinadas cuentas de miembros (`GetMembers`)
+ Invitar cuentas de miembros al gráfico de comportamiento (`CreateMembers`)
+ Eliminar miembros del gráfico de comportamiento (`DeleteMembers`)
En lugar de enumerar estas acciones por separado, puede otorgar acceso a todas las acciones que terminan con la palabra `Members`. La política necesaria para ello incluiría la siguiente acción:
```
"Action": "detective:*Members"
```
Para ver una lista de las acciones de Detective, consulte [Acciones definidas por Amazon Detective](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazondetective.html#amazondetective-actions-as-permissions) en la *Referencia de autorizaciones de servicio*.
### Recursos
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.
El elemento `Resource` de la política JSON especifica el objeto u objetos a los que se aplica la acción. Como práctica recomendada, especifique un recurso utilizando el [Nombre de recurso de Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). En el caso de las acciones que no admiten permisos por recurso, utilice un carácter comodín (\$1) para indicar que la instrucción se aplica a todos los recursos.
```
"Resource": "*"
```
Para obtener más información sobre el formato de ARNs, consulte [Amazon Resource Names (ARNs) y AWS Service Namespaces](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
En el caso de Detective, el único tipo de recurso disponible es el gráfico de comportamiento. El recurso del gráfico de comportamiento de Detective tiene el siguiente ARN:
```
arn:aws:detective:${Region}:${AccountId}:graph:${GraphId}
```
En este ejemplo, el gráfico de comportamiento tiene los siguientes valores:
+ La región del gráfico de comportamiento es `us-east-1`.
+ El ID de la cuenta de administrador es `111122223333`.
+ El ID del gráfico de comportamiento es `027c7c4610ea4aacaf0b883093cab899`.
Si quisiera identificar este gráfico de comportamiento en una instrucción `Resource`, tendría que utilizar el siguiente ARN:
```
"Resource": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899"
```
Se utilizan comas para separar los distintos recursos de una instrucción `Resource`.
```
"Resource": [
"resource1",
"resource2"
]
```
Por ejemplo, se puede invitar a la misma AWS cuenta a ser una cuenta miembro en más de un gráfico de comportamiento. En este caso, en la política de dicha cuenta de miembro, la instrucción `Resource` indica los gráficos de comportamiento a los que se ha invitado la cuenta.
```
"Resource": [
"arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899",
"arn:aws:detective:us-east-1:444455556666:graph:056d2a9521xi2bbluw1d164680eby416"
]
```
Algunas acciones de Detective, como crear un gráfico de comportamiento y enumerar gráficos de comportamiento o sus correspondientes invitaciones, no se llevan a cabo para un gráfico de comportamiento en concreto. En el caso de estas acciones, la instrucción `Resource` debe incluir el carácter comodín (\$1).
```
"Resource": "*"
```
En el caso de las acciones de la cuenta de administrador, Detective verifica siempre que el usuario que ha realizado la solicitud pertenece a la cuenta de administrador del gráfico de comportamiento correspondiente. En el caso de las acciones de cuentas de miembros, Detective verifica siempre que el usuario que ha realizado la solicitud pertenece a la cuenta de miembro. Incluso si una política de IAM concede acceso a un gráfico de comportamiento, si el usuario no pertenece a la cuenta correcta, no podrá realizar la acción.
La política de IAM debe incluir el ARN del gráfico en todas las acciones que se lleven a cabo para un gráfico de comportamiento específico. El ARN del gráfico se puede agregar más adelante. Por ejemplo, cuando una cuenta habilita Detective por primera vez, la política de IAM inicial proporciona acceso a todas las acciones de Detective, ya que se utiliza el carácter comodín para el ARN del gráfico. De esta forma, el usuario puede empezar a administrar de inmediato las cuentas de miembros y llevar a cabo investigaciones con el gráfico de comportamiento. Una vez que se ha creado el gráfico de comportamiento, puede agregar el ARN del gráfico a la política y actualizarla.
### Claves de condición
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.
El elemento `Condition` especifica cuándo se ejecutan las instrucciones en función de criterios definidos. Puede crear expresiones condicionales que utilizan [operadores de condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), tales como igual o menor que, para que la condición de la política coincida con los valores de la solicitud. Para ver todas las claves de condición AWS globales, consulte las claves de [contexto de condición AWS globales](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) en la *Guía del usuario de IAM*.
Detective no define su propio conjunto de claves de condición, aunque sí admite el uso de claves de condición globales. Para ver todas las claves de condición AWS globales, consulte las claves de [contexto de condición AWS globales](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) en la Guía del *usuario de IAM*.
Para obtener información sobre las acciones y los recursos que le permiten utilizar una clave de condición, consulte [Acciones definidas por Amazon Detective](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazondetective.html#amazondetective-actions-as-permissions).
### Ejemplos
Para ver ejemplos de políticas basadas en identidades de Detective, consulte [Ejemplos de políticas de basadas en identidades de Amazon Detective](security_iam_id-based-policy-examples.md).
## Políticas de Detective basadas en recursos (no compatibles)
Detective no admite políticas basadas en recursos.
## Autorización basada en etiquetas de gráficos de comportamiento de Detective
Se pueden asignar valores de etiqueta a cada gráfico de comportamiento. Puede utilizar estos valores de etiqueta en instrucciones de condición para administrar el acceso al gráfico de comportamiento.
La instrucción de condición de un valor de etiqueta utiliza el siguiente formato.
```
{"StringEquals"{"aws:ResourceTag/": ""}}
```
En el siguiente ejemplo, el código se utiliza para permitir o denegar una acción cuando el valor de la etiqueta `Department` es `Finance`.
```
{"StringEquals"{"aws:ResourceTag/Department": "Finance"}}
```
Para ver ejemplos de políticas que utilizan valores de etiqueta de recursos, consulte [Cuenta de administrador: restricción del acceso en función de valores de etiqueta](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-graph-tags).
## Roles de IAM en Detective
Un [rol de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) es una entidad de tu AWS cuenta que tiene permisos específicos.
### Uso de credenciales temporales con Detective
Puede utilizar credenciales temporales para iniciar sesión con federación, asumir un rol de IAM o asumir un rol de acceso entre cuentas. Para obtener credenciales de seguridad temporales, puede llamar a operaciones de AWS STS API como [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)o [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html).
Detective admite el uso de credenciales temporales.
### Roles vinculados a servicios
Los [roles vinculados a un servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) permiten a AWS los servicios acceder a los recursos de otros servicios para completar una acción en tu nombre. Los roles vinculados a servicios aparecen en la cuenta de IAM y son propiedad del servicio. Un administrador de IAM puede ver, pero no editar, los permisos de los roles vinculados a servicios.
Para obtener más información acerca de cómo crear o administrar roles vinculados a servicios de Detective, consulte [Usar roles vinculados a servicios para Detective](using-service-linked-roles.md).
### Roles de servicio (no compatibles)
Esta característica permite que un servicio asuma un [rol de servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) en su nombre. Este rol permite que el servicio obtenga acceso a los recursos de otros servicios para completar una acción en su nombre. Los roles de servicio aparecen en su cuenta de IAM y son propiedad de la cuenta. Esto significa que un administrador de IAM puede cambiar los permisos de este rol. Sin embargo, hacerlo podría deteriorar la funcionalidad del servicio.
Detective no admite roles de servicio.
# Ejemplos de políticas de basadas en identidades de Amazon Detective
De forma predeterminada, los usuarios y los roles de IAM no tienen permiso para crear o modificar recursos de Detective. Tampoco pueden realizar tareas con la API Consola de administración de AWS AWS CLI, o AWS .
Un administrador de IAM debe crear políticas de IAM que concedan permisos a los usuarios y a los roles para realizar operaciones de la API concretas en los recursos especificados que necesiten. En ese caso, el administrador debe asociar esas políticas a los usuarios o grupos de IAM que necesiten esos permisos.
Para obtener información acerca de cómo crear una política basada en identidad de IAM con estos documentos de políticas JSON de ejemplo, consulte [Creación de políticas en la pestaña JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor) en la *Guía del usuario de IAM*.
**Topics**
+ [Prácticas recomendadas relativas a políticas](#security_iam_service-with-iam-policy-best-practices)
+ [Uso de la consola de Detective](#security_iam_id-based-policy-examples-console)
+ [Cómo permitir a los usuarios que vean sus propios permisos](#security_iam_id-based-policy-examples-view-own-permissions)
+ [Cuenta de administrador: administración de cuentas de miembros en un gráfico de comportamiento](#security_iam_id-based-policy-examples-admin-account-mgmt)
+ [Cuenta de administrador: uso de un gráfico de comportamiento con fines de investigación](#security_iam_id-based-policy-examples-admin-investigate)
+ [Cuenta de miembro: administración de las invitaciones y suscripciones a gráficos de comportamiento](#security_iam_id-based-policy-examples-member-account)
+ [Cuenta de administrador: restricción del acceso en función de valores de etiqueta](#security_iam_id-based-policy-examples-graph-tags)
## Prácticas recomendadas relativas a políticas
Las políticas basadas en identidades determinan si alguien puede crear o eliminar los recursos de Detective de la cuenta, o bien acceder a estos. Estas acciones pueden generar costos adicionales para su Cuenta de AWS. Siga estas directrices y recomendaciones al crear o editar políticas basadas en identidades:
+ **Comience con las políticas AWS administradas y avance hacia los permisos con privilegios mínimos**: para empezar a conceder permisos a sus usuarios y cargas de trabajo, utilice las *políticas AWS administradas* que otorgan permisos en muchos casos de uso comunes. Están disponibles en su. Cuenta de AWS Le recomendamos que reduzca aún más los permisos definiendo políticas administradas por el AWS cliente que sean específicas para sus casos de uso. Con el fin de obtener más información, consulte las [políticas administradas por AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) o las [políticas administradas por AWS para funciones de tarea](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html) en la *Guía de usuario de IAM*.
+ **Aplique permisos de privilegio mínimo**: cuando establezca permisos con políticas de IAM, conceda solo los permisos necesarios para realizar una tarea. Para ello, debe definir las acciones que se pueden llevar a cabo en determinados recursos en condiciones específicas, también conocidos como *permisos de privilegios mínimos*. Con el fin de obtener más información sobre el uso de IAM para aplicar permisos, consulte [Políticas y permisos en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) en la *Guía del usuario de IAM*.
+ **Utilice condiciones en las políticas de IAM para restringir aún más el acceso**: puede agregar una condición a sus políticas para limitar el acceso a las acciones y los recursos. Por ejemplo, puede escribir una condición de políticas para especificar que todas las solicitudes deben enviarse utilizando SSL. También puedes usar condiciones para conceder el acceso a las acciones del servicio si se utilizan a través de una acción específica Servicio de AWS, por ejemplo CloudFormation. Para obtener más información, consulte [Elementos de la política de JSON de IAM: Condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) en la *Guía del usuario de IAM*.
+ **Utiliza el analizador de acceso de IAM para validar las políticas de IAM con el fin de garantizar la seguridad y funcionalidad de los permisos**: el analizador de acceso de IAM valida políticas nuevas y existentes para que respeten el lenguaje (JSON) de las políticas de IAM y las prácticas recomendadas de IAM. El analizador de acceso de IAM proporciona más de 100 verificaciones de políticas y recomendaciones procesables para ayudar a crear políticas seguras y funcionales. Para más información, consulte [Validación de políticas con el Analizador de acceso de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html) en la *Guía del usuario de IAM*.
+ **Requerir autenticación multifactor (MFA**): si tiene un escenario que requiere usuarios de IAM o un usuario raíz en Cuenta de AWS su cuenta, active la MFA para mayor seguridad. Para exigir la MFA cuando se invoquen las operaciones de la API, añada condiciones de MFA a sus políticas. Para más información, consulte [Acceso seguro a la API con MFA](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html) en la *Guía del usuario de IAM*.
Para obtener más información sobre las prácticas recomendadas de IAM, consulte [Prácticas recomendadas de seguridad en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) en la *Guía del usuario de IAM*.
## Uso de la consola de Detective
Para utilizar la consola de Amazon Detective, el usuario o el rol deben poder acceder a las acciones pertinentes, que deben coincidir con las acciones correspondientes de la API.
Para habilitar Detective y trabajar con una cuenta de administrador en un gráfico de comportamiento, el usuario o el rol deben tener permiso para realizar la acción `CreateGraph`.
Para llevar a cabo acciones de la cuenta de administrador con la consola de Detective, el usuario o el rol deben tener permiso para realizar la acción `ListGraphs`. Esta acción concede permiso para obtener los gráficos de comportamiento en los que la cuenta tiene funciones de administrador. También debe tener permiso para realizar acciones específicas de la cuenta de administrador.
Las acciones más básicas de la cuenta de administrador son visualizar una lista de las cuentas de miembros de un gráfico de comportamiento y utilizar el gráfico de comportamiento con fines de investigación.
+ Para ver una lista con las cuentas de miembros de un gráfico de comportamiento, la entidad principal debe tener permiso para realizar la acción `ListMembers`.
+ Para investigar un gráfico de comportamiento, la entidad principal debe tener permiso para realizar la acción `SearchGraph`.
Para llevar a cabo acciones de una cuenta de miembro con la consola de Detective, el usuario o el rol deben tener permiso para realizar la acción `ListInvitations`. Esta acción concede permiso para ver las invitaciones a gráficos de rendimiento. También pueden obtener permiso para realizar ciertas acciones de cuentas de miembro.
## Cómo permitir a los usuarios que vean sus propios permisos
En este ejemplo, se muestra cómo podría crear una política que permita a los usuarios de IAM ver las políticas administradas e insertadas que se asocian a la identidad de sus usuarios. Esta política incluye permisos para completar esta acción en la consola o mediante programación mediante la API o. AWS CLI AWS
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ViewOwnUserInfo",
"Effect": "Allow",
"Action": [
"iam:GetUserPolicy",
"iam:ListGroupsForUser",
"iam:ListAttachedUserPolicies",
"iam:ListUserPolicies",
"iam:GetUser"
],
"Resource": ["arn:aws:iam::*:user/${aws:username}"]
},
{
"Sid": "NavigateInConsole",
"Effect": "Allow",
"Action": [
"iam:GetGroupPolicy",
"iam:GetPolicyVersion",
"iam:GetPolicy",
"iam:ListAttachedGroupPolicies",
"iam:ListGroupPolicies",
"iam:ListPolicyVersions",
"iam:ListPolicies",
"iam:ListUsers"
],
"Resource": "*"
}
]
}
```
## Cuenta de administrador: administración de cuentas de miembros en un gráfico de comportamiento
Este ejemplo de política está dirigido a los usuarios de cuentas de administrador que tan solo son responsables de administrar las cuentas de miembros incluidas en un gráfico de rendimiento. Asimismo, la política permite al usuario ver información sobre el uso y desactivar Detective. La política no concede permiso para utilizar el gráfico de comportamiento con fines de investigación.
------
#### [ JSON ]
****
```
{"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":["detective:ListMembers","detective:CreateMembers","detective:DeleteMembers","detective:DeleteGraph","detective:Get*","detective:StartMonitoringMember"],
"Resource":"arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899"
},
{
"Effect":"Allow",
"Action":["detective:CreateGraph","detective:ListGraphs"],
"Resource":"*"
}
]
}
```
------
## Cuenta de administrador: uso de un gráfico de comportamiento con fines de investigación
Este ejemplo de política está dirigido a los usuarios de cuentas de administrador que utilizan el gráfico de comportamiento únicamente con fines de investigación. No pueden ver ni editar la lista con las cuentas de miembros del gráfico de rendimiento.
------
#### [ JSON ]
****
```
{"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":["detective:SearchGraph"],
"Resource":"arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899"
},
{
"Effect":"Allow",
"Action":["detective:ListGraphs"],
"Resource":"*"
}
]
}
```
------
## Cuenta de miembro: administración de las invitaciones y suscripciones a gráficos de comportamiento
Este ejemplo de política está dirigido a los usuarios que pertenecen a una cuenta de miembro. En este ejemplo, la cuenta de miembro está incluida en dos gráficos de comportamiento. La política concede permiso para responder a las invitaciones y eliminar la cuenta de miembro del gráfico de comportamiento.
------
#### [ JSON ]
****
```
{"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":["detective:AcceptInvitation","detective:RejectInvitation","detective:DisassociateMembership"],
"Resource":[
"arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899",
"arn:aws:detective:us-east-1:444455556666:graph:056d2a9521xi2bbluw1d164680eby416"
]
},
{
"Effect":"Allow",
"Action":["detective:ListInvitations"],
"Resource":"*"
}
]
}
```
------
## Cuenta de administrador: restricción del acceso en función de valores de etiqueta
La siguiente política permite al usuario utilizar un gráfico de comportamiento con fines de investigación si la etiqueta `SecurityDomain` del gráfico de comportamiento coincide con la etiqueta `SecurityDomain` del usuario.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"detective:SearchGraph"
],
"Resource": "arn:aws:detective:*:*:graph:*",
"Condition": {
"StringEquals": {
"aws:ResourceTag/SecurityDomain": "aws:PrincipalTag/SecurityDomain"
}
}
},
{
"Effect": "Allow",
"Action": [
"detective:ListGraphs"
],
"Resource": "*"
}
]
}
```
------
La siguiente política evita que los usuarios puedan utilizar un gráfico de comportamiento con fines de investigación si el valor de la etiqueta `SecurityDomain` del gráfico de comportamiento es `Finance`.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[ {
"Effect":"Deny",
"Action":["detective:SearchGraph"],
"Resource":"arn:aws:detective:*:*:graph:*",
"Condition": {
"StringEquals": {"aws:ResourceTag/SecurityDomain": "Finance"}
}
} ]
}
```
------
# AWS políticas gestionadas para Amazon Detective
Una política AWS administrada es una política independiente creada y administrada por AWS. AWS Las políticas administradas están diseñadas para proporcionar permisos para muchos casos de uso comunes, de modo que pueda empezar a asignar permisos a usuarios, grupos y funciones.
Ten en cuenta que es posible que las políticas AWS administradas no otorguen permisos con privilegios mínimos para tus casos de uso específicos, ya que están disponibles para que los usen todos los AWS clientes. Se recomienda definir [políticas administradas por el cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies) específicas para sus casos de uso a fin de reducir aún más los permisos.
No puedes cambiar los permisos definidos en AWS las políticas administradas. Si AWS actualiza los permisos definidos en una política AWS administrada, la actualización afecta a todas las identidades principales (usuarios, grupos y roles) a las que está asociada la política. AWS es más probable que actualice una política AWS administrada cuando Servicio de AWS se lance una nueva o cuando estén disponibles nuevas operaciones de API para los servicios existentes.
Para obtener más información, consulte [Políticas administradas por AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) en la *Guía del usuario de IAM*.
## AWS política gestionada: AmazonDetectiveFullAccess
Puede adjuntar la política `AmazonDetectiveFullAccess` a sus identidades de IAM.
Esta política otorga permisos administrativos que brindan a una entidad principal acceso completo a todas las acciones de Amazon Detective. También puede adjuntar esta política a una entidad principal antes de que esta habilite Detective en su cuenta. También debe adjuntarse al rol que se utiliza para ejecutar los scripts de Detective Python para crear y administrar un gráfico de comportamiento.
Las entidades principales con estos permisos pueden administrar cuentas de miembro, agregar etiquetas a su gráfico de comportamiento y usar Detective con fines de investigación. También pueden archivar GuardDuty los hallazgos. La política proporciona los permisos que la consola de Detective necesita para mostrar los nombres de las cuentas en las que se encuentran AWS Organizations.
**Detalles de los permisos**
Esta política incluye los permisos siguientes:
+ `detective`: permite a las entidades principales obtener acceso completo a todas las acciones de Detective.
+ `organizations`: permite a las entidades principales recuperar de AWS Organizations información sobre las cuentas de una organización. Si una cuenta pertenece a una organización, estos permisos permiten que la consola de Detective muestre los nombres de las cuentas además de los números de cuenta.
+ `guardduty`— Permite a los directores obtener y archivar GuardDuty los hallazgos desde Detective.
+ `securityhub`— Permite a los directores obtener los hallazgos del CSPM de Security Hub desde Detective.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"detective:*",
"organizations:DescribeOrganization",
"organizations:ListAccounts"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"guardduty:ArchiveFindings"
],
"Resource": "arn:aws:guardduty:*:*:detector/*"
},
{
"Effect": "Allow",
"Action": [
"guardduty:GetFindings",
"guardduty:ListDetectors"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"securityHub:GetFindings"
],
"Resource": "*"
}
]
}
```
------
## AWS política gestionada: AmazonDetectiveMemberAccess
También puede adjuntar la política `AmazonDetectiveMemberAccess` a sus entidades de IAM.
Esta política proporciona acceso de miembro a Amazon Detective y acceso limitado a la consola.
Con esta política, puede:
+ Ver las invitaciones de pertenencia a gráficos de Detective y aceptar o rechazar dichas invitaciones.
+ Ver cómo su actividad en Detective contribuye al costo de uso del servicio en la página **Uso**.
+ Renunciar a su pertenencia a un gráfico.
Esta política otorga permisos de solo lectura que brindan acceso limitado a la consola de Detective.
**Detalles de los permisos**
Esta política incluye los permisos siguientes:
+ `detective`: permite a los miembros acceder a Detective.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"detective:AcceptInvitation",
"detective:BatchGetMembershipDatasources",
"detective:DisassociateMembership",
"detective:GetFreeTrialEligibility",
"detective:GetPricingInformation",
"detective:GetUsageInformation",
"detective:ListInvitations",
"detective:RejectInvitation"
],
"Resource": "*"
}
]
}
```
------
## AWS política gestionada: AmazonDetectiveInvestigatorAccess
Puede adjuntar la política `AmazonDetectiveInvestigatorAccess` a sus entidades de IAM.
Esta política proporciona acceso de investigador al servicio de Detective y acceso limitado a las dependencias de la interfaz de usuario de la consola de Detective. Esta política concede permisos para habilitar las investigaciones de Detective en Detective para usuarios y roles de IAM. Puede investigar para identificar los indicadores de riesgo, por ejemplo, resultados, utilizando un informe de investigación que proporciona análisis e información sobre indicadores de seguridad. El informe se clasifica por gravedad, que se determina mediante el análisis de comportamiento y machine learning de Detective. Puede utilizar el informe para priorizar la corrección de los recursos.
**Detalles de los permisos**
Esta política incluye los permisos siguientes:
+ `detective`: proporciona a las entidades principales acceso de investigador a las acciones de Detective para habilitar investigaciones de Detective y resumen de grupo de resultados.
+ `guardduty`— Permite a los directores obtener y archivar GuardDuty los hallazgos desde Detective.
+ `securityhub`— Permite a los directores obtener los hallazgos del CSPM de Security Hub desde Detective.
+ `organizations`— Permite a los directores recuperar información sobre las cuentas de una organización desde. AWS Organizations Si una cuenta pertenece a una organización, estos permisos permiten que la consola de Detective muestre los nombres de las cuentas además de los números de cuenta.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DetectivePermissions",
"Effect": "Allow",
"Action": [
"detective:BatchGetGraphMemberDatasources",
"detective:BatchGetMembershipDatasources",
"detective:DescribeOrganizationConfiguration",
"detective:GetFreeTrialEligibility",
"detective:GetGraphIngestState",
"detective:GetMembers",
"detective:GetPricingInformation",
"detective:GetUsageInformation",
"detective:ListDatasourcePackages",
"detective:ListGraphs",
"detective:ListHighDegreeEntities",
"detective:ListInvitations",
"detective:ListMembers",
"detective:ListOrganizationAdminAccount",
"detective:ListTagsForResource",
"detective:SearchGraph",
"detective:StartInvestigation",
"detective:GetInvestigation",
"detective:ListInvestigations",
"detective:UpdateInvestigationState",
"detective:ListIndicators",
"detective:InvokeAssistant"
],
"Resource": "*"
},
{
"Sid": "OrganizationsPermissions",
"Effect": "Allow",
"Action": [
"organizations:DescribeOrganization",
"organizations:ListAccounts"
],
"Resource": "*"
},
{
"Sid": "GuardDutyPermissions",
"Effect": "Allow",
"Action": [
"guardduty:ArchiveFindings",
"guardduty:GetFindings",
"guardduty:ListDetectors"
],
"Resource": "*"
},
{
"Sid": "SecurityHubPermissions",
"Effect": "Allow",
"Action": [
"securityHub:GetFindings"
],
"Resource": "*"
}
]
}
```
------
## AWS política gestionada: AmazonDetectiveOrganizationsAccess
Puede adjuntar la política `AmazonDetectiveOrganizationsAccess` a sus entidades de IAM.
Esta política concede permiso para habilitar y administrar Amazon Detective dentro de una organización. Puede habilitar Detective en toda la organización y determinar la cuenta de administrador delegada para Detective.
**Detalles de los permisos**
Esta política incluye los permisos siguientes:
+ `detective`: permite a las entidades principales acceder a las acciones de Detective.
+ `iam`: especifica que se cree un rol vinculado a un servicio cuando el Detective llama a `EnableOrganizationAdminAccount`.
+ `organizations`— Permite a los directores recuperar información sobre las cuentas de una organización desde AWS Organizations. Si una cuenta pertenece a una organización, estos permisos permiten que la consola de Detective muestre los nombres de las cuentas además de los números de cuenta. Permite la integración de un AWS servicio, permite registrar y anular el registro de la cuenta de miembro especificada como administrador delegado y permite a los directores recuperar cuentas de administrador delegado en otros servicios de seguridad como Amazon Detective, Amazon, Amazon GuardDuty Macie y. AWS Security Hub CSPM
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"detective:DisableOrganizationAdminAccount",
"detective:EnableOrganizationAdminAccount",
"detective:ListOrganizationAdminAccount"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"iam:AWSServiceName": "detective.amazonaws.com"
}
}
},
{
"Effect": "Allow",
"Action": [
"organizations:EnableAWSServiceAccess",
"organizations:RegisterDelegatedAdministrator",
"organizations:DeregisterDelegatedAdministrator"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"organizations:ServicePrincipal": [
"detective.amazonaws.com"
]
}
}
},
{
"Effect": "Allow",
"Action": [
"organizations:DescribeAccount",
"organizations:DescribeOrganization",
"organizations:ListAccounts"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"organizations:ListDelegatedAdministrators"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"organizations:ServicePrincipal": [
"detective.amazonaws.com",
"guardduty.amazonaws.com",
"macie.amazonaws.com",
"securityhub.amazonaws.com"
]
}
}
}
]
}
```
------
## AWS política gestionada: AmazonDetectiveServiceLinkedRole
No puede asociar la política `AmazonDetectiveServiceLinkedRole` a sus entidades de IAM. Esta política está adjunta a un rol vinculado a un servicio que permite a Detective realizar acciones en su nombre. Para obtener más información, consulte [Usar roles vinculados a servicios para Detective](using-service-linked-roles.md).
Esta política concede permisos administrativos que autorizan al rol vinculado al servicio acceder a información sobre las cuentas de una organización.
**Detalles de los permisos**
Esta política incluye los permisos siguientes:
+ `organizations`: recupera la información sobre las cuentas de una organización.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"organizations:DescribeAccount",
"organizations:ListAccounts"
],
"Resource": "*"
}
]
}
```
------
## Actualizaciones de Detectives de las políticas AWS gestionadas
Vea los detalles sobre las actualizaciones de las políticas AWS administradas para Detective desde que este servicio comenzó a rastrear estos cambios. Para obtener alertas automáticas sobre los cambios realizados en esta página, suscríbase a la fuente RSS en la [Página del historial de revisión de ](doc-history.md).
| Cambio | Descripción | Fecha |
| --- | --- | --- |
| [AmazonDetectiveInvestigatorAccess](#security-iam-awsmanpol-amazondetectiveinvestigatoraccesspolicy): actualizaciones de políticas existentes | Se agregaron a la política de `AmazonDetectiveInvestigatorAccess` acciones de resumen de grupos de investigaciones y resultados de Detective. Estas acciones permiten iniciar, recuperar y actualizar las investigaciones de Detective y obtener un resumen de grupo de resultados desde Detective. | 26 de noviembre de 2023 |
| [AmazonDetectiveFullAccess](#security-iam-awsmanpol-amazondetectivefullaccess) y [AmazonDetectiveInvestigatorAccess](#security-iam-awsmanpol-amazondetectiveorganizationsaccesspolicy): actualizaciones de las políticas existentes | El Detective agregó las `GetFindings` acciones CSPM de Security Hub a las políticas `AmazonDetectiveFullAccess` y`AmazonDetectiveInvestigatorAccess`. Estas acciones permiten obtener los hallazgos del CSPM de Security Hub desde Detective. | 16 de mayo de 2023 |
| [AmazonDetectiveOrganizationsAccess](#security-iam-awsmanpol-amazondetectiveorganizationsaccesspolicy): política nueva | Detective agregó la política `AmazonDetectiveOrganizationsAccess`. Esta política otorga permiso para habilitar y administrar Detective dentro de una organización. | 2 de marzo de 2023 |
| [AmazonDetectiveMemberAccess](#security-iam-awsmanpol-amazondetectivememberaccess): política nueva | Detective agregó la política `AmazonDetectiveMemberAccess`. Esta política proporciona acceso de miembro a Detective y acceso limitado a las dependencias de la interfaz de usuario de la consola. | 17 de enero de 2023 |
| [AmazonDetectiveFullAccess](#security-iam-awsmanpol-amazondetectivefullaccess): actualizaciones de una política existente | El Detective agregó GuardDuty `GetFindings` acciones a la `AmazonDetectiveFullAccess` política. Estas acciones permiten obtener GuardDuty hallazgos desde el interior de Detective. | 17 de enero de 2023 |
| [AmazonDetectiveInvestigatorAccess](#security-iam-awsmanpol-amazondetectiveinvestigatoraccesspolicy): política nueva | Detective agregó la política `AmazonDetectiveInvestigatorAccess`. Esta política permite a la entidad principal realizar investigaciones en Detective. | 17 de enero de 2023 |
| [AmazonDetectiveServiceLinkedRole](#security-iam-awsmanpol-amazondetectiveservicelinkedrolepolicy): política nueva | Detective agregó una nueva política para su rol vinculado al servicio. La política permite al rol vinculado al servicio recuperar información sobre las cuentas de una organización. | 16 de diciembre de 2021 |
| Detective comenzó a hacer el seguimiento de los cambios | Detective comenzó a realizar un seguimiento de los cambios en sus políticas AWS gestionadas. | 10 de mayo de 2021 |
# Usar roles vinculados a servicios para Detective
Amazon Detective utiliza funciones AWS Identity and Access Management vinculadas al [servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) (IAM). Un rol vinculado a un servicio es un tipo único de rol de IAM que está vinculado directamente a Detective. Los roles vinculados al servicio están predefinidos por el Detective e incluyen todos los permisos que el servicio requiere para llamar a otros AWS servicios en su nombre.
Un rol vinculado a un servicio simplifica la configuración de Detective al evitar que se tengan que agregar manualmente los permisos necesarios. Detective define los permisos de sus roles vinculados al servicio y, salvo que se defina de otro modo, solo Detective puede asumir sus roles. Los permisos definidos incluyen las políticas de confianza y de permisos, y que la política de permisos no se pueda adjuntar a ninguna otra entidad de IAM.
Solo es posible eliminar un rol vinculado a un servicio después de eliminar sus recursos relacionados. Esto protege sus recursos de Detective, ya que evita que se puedan eliminar accidentalmente permisos de acceso a los recursos.
Para obtener información sobre otros servicios que admiten roles vinculados a servicios, consulte [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) y busque los servicios que muestran **Sí** en la columna **Rol vinculado a servicio**. Seleccione una opción **Sí** con un enlace para ver la documentación acerca del rol vinculado al servicio en cuestión.
## Permisos de rol vinculado a servicio de Detective
El Detective usa el rol vinculado al servicio denominado **AWSServiceRoleForDetective**: permite que el Detective acceda a la AWS Organizations información en su nombre.
El rol AWSService RoleForDetective vinculado al servicio confía en los siguientes servicios para asumir el rol:
+ `detective.amazonaws.com`
El rol AWSService RoleForDetective vinculado al servicio usa la política administrada. [`AmazonDetectiveServiceLinkedRolePolicy`](security-iam-awsmanpol.md#security-iam-awsmanpol-amazondetectiveservicelinkedrolepolicy)
Para obtener más información sobre las actualizaciones de la `AmazonDetectiveServiceLinkedRolePolicy` política, consulta [Amazon Detective actualiza las políticas AWS gestionadas](https://docs.aws.amazon.com//detective/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-updates). Para recibir alertas automáticas sobre los cambios en esta política, suscríbase a la fuente RSS de la página del [historial de documentos del Detective](https://docs.aws.amazon.com//detective/latest/userguide/doc-history.html).
Debe configurar permisos para permitir a una entidad de IAM (como un usuario, grupo o rol) crear, editar o eliminar un rol vinculado a servicios. Para obtener más información, consulte [Permisos de roles vinculados a servicios](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) en la *Guía del usuario de IAM*.
## Crear un rol vinculado a servicio para Detective
No necesita crear manualmente un rol vinculado a un servicio. Cuando designa la cuenta de administrador de Detective para una organización en la Consola de administración de AWS AWS CLI, la o la AWS API, Detective crea el rol vinculado al servicio para usted.
Si elimina este rol vinculado a servicios y necesita crearlo de nuevo, puede utilizar el mismo proceso para volver a crear el rol en su cuenta. Al designar la cuenta de administrador de Detective de una organización, Detective crea el rol vinculado al servicio en su nombre una vez más.
## Editar un rol vinculado a servicio para Detective
Detective no le permite editar el rol AWSService RoleForDetective vinculado al servicio. Después de crear un rol vinculado al servicio, no podrá cambiar el nombre del rol, ya que varias entidades podrían hacer referencia al rol. Sin embargo, sí puede editar la descripción del rol con IAM. Para obtener más información, consulte [Editar un rol vinculado a servicios](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) en la *Guía del usuario de IAM*.
## Eliminar un rol vinculado a un servicio para Detective
Si ya no necesita usar una característica o servicio que requieran un rol vinculado a un servicio, le recomendamos que elimine dicho rol. Así no tendrá una entidad no utilizada que no se supervise ni mantenga de forma activa. Sin embargo, debe limpiar los recursos de su rol vinculado al servicio antes de eliminarlo manualmente.
**nota**
Si el servicio Detective está utilizando el rol mientras usted intenta eliminar los recursos, la eliminación podría fallar. Si esto sucede, espere unos minutos y reintente la operación.
**Para eliminar los recursos de Detective utilizados por el AWSService RoleForDetective**
1. Elimine la cuenta de administrador de Detective. Consulte [Designación del Detective administrador de una organización](accounts-designate-admin.md).
1. Repita el proceso en cada región en la que haya designado la cuenta de administrador de Detective.
**Para eliminar manualmente el rol vinculado al servicio con IAM**
Utilice la consola de IAM AWS CLI, la o la AWS API para eliminar la función vinculada al AWSService RoleForDetective servicio. Para obtener más información, consulte [Eliminar un rol vinculado a un servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) en la *Guía del usuario de IAM*.
## Regiones admitidas para los roles vinculados a servicios de Detective
Detective admite el uso de roles vinculados a servicios en todas las regiones en las que el servicio está disponible. Para obtener más información, consulte [Regiones y puntos de conexión de AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html).
# Solución de problemas de identidad y acceso de Amazon Detective
Utilice la siguiente información para diagnosticar y solucionar los problemas comunes que puedan surgir cuando trabaje con Detective e IAM. *Si encuentra problemas de acceso denegado o dificultades similares al trabajar con AWS Identity and Access Management(IAM), consulte los temas de solución de [problemas de IAM en la Guía del usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot.html).*
## No tengo autorización para realizar una acción en Detective
Si Consola de administración de AWS le indica que no está autorizado a realizar una acción, póngase en contacto con su administrador para obtener ayuda. El administrador es la persona que le facilitó el nombre de usuario y la contraseña.
El siguiente ejemplo de error ocurre cuando el usuario de IAM `mateojackson` intenta utilizar la consola para aceptar una invitación y ser cuenta de miembro de un gráfico de rendimiento, pero no cuenta con permisos `detective:AcceptInvitation`.
```
User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: detective:AcceptInvitation on resource: arn:aws:detective:us-east-1:444455556666:graph:567856785678
```
En este caso, Mateo pide a su administrador que actualice sus políticas de forma que pueda obtener acceso al recurso `arn:aws:detective:us-east-1:444455556666:graph:567856785678` mediante la acción `detective:AcceptInvitation`.
## No estoy autorizado a realizar lo siguiente: PassRole
Si recibe un error que indica que no tiene autorización para realizar la acción `iam:PassRole`, se deben actualizar las políticas a fin de permitirle pasar un rol a Detective.
Algunas Servicios de AWS permiten transferir una función existente a ese servicio en lugar de crear una nueva función de servicio o una función vinculada a un servicio. Para ello, debe tener permisos para transferir la función al servicio.
En el siguiente ejemplo, el error se produce cuando un usuario de IAM denominado `marymajor` intenta utilizar la consola para realizar una acción en Detective. Sin embargo, la acción requiere que el servicio cuente con permisos que otorguen un rol de servicio. Mary no tiene permisos para transferir el rol al servicio.
```
User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole
```
En este caso, las políticas de Mary se deben actualizar para permitirle realizar la acción `iam:PassRole`.
Si necesita ayuda, póngase en contacto con su AWS administrador. El administrador es la persona que le proporcionó las credenciales de inicio de sesión.
## Quiero permitir que personas ajenas a mi AWS cuenta accedan a mis recursos de Detective
Se puede crear un rol que los usuarios de otras cuentas o las personas externas a la organización puedan utilizar para acceder a sus recursos. Se puede especificar una persona de confianza para que asuma el rol. En el caso de los servicios que admiten políticas basadas en recursos o listas de control de acceso (ACLs), puedes usar esas políticas para permitir que las personas accedan a tus recursos.
Para obtener más información, consulte lo siguiente:
+ Para obtener información acerca de si Detective admite estas características, consulte [Cómo funciona Amazon Detective con IAM](security_iam_service-with-iam.md).
+ Para obtener información sobre cómo proporcionar acceso a los recursos de su Cuentas de AWS propiedad, consulte [Proporcionar acceso a un usuario de IAM en otro de su propiedad en la Cuenta de AWS Guía del usuario](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html) de *IAM*.
+ Para obtener información sobre cómo proporcionar acceso a tus recursos a terceros Cuentas de AWS, consulta Cómo [proporcionar acceso a recursos que Cuentas de AWS son propiedad de terceros](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html) en la Guía del usuario de *IAM*.
+ Para obtener información sobre cómo proporcionar acceso mediante una federación de identidades, consulte [Proporcionar acceso a usuarios autenticados externamente (identidad federada)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html) en la *Guía del usuario de IAM*.
+ Para conocer sobre la diferencia entre las políticas basadas en roles y en recursos para el acceso entre cuentas, consulte [Acceso a recursos entre cuentas en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) en la *Guía del usuario de IAM*.