Gestión de identidad y acceso para AWS CodeStar notificaciones y AWS CodeConnections

AWS Identity and Access Management (IAM) es una herramienta Servicio de AWS que ayuda al administrador a controlar de forma segura el acceso a los AWS recursos. Los administradores de IAM controlan quién puede autenticarse (iniciar sesión) y quién puede autorizarse (tener permisos) para usar AWS CodeStar las notificaciones y los recursos. AWS CodeConnections La IAM es una Servicio de AWS opción que puede utilizar sin coste adicional.

nota

Están disponibles las acciones para los recursos que se crean con el nuevo prefijo codeconnections de servicio. La creación de un recurso con el nuevo prefijo de servicio se utilizará codeconnections en el ARN del recurso. Las acciones y los recursos del prefijo codestar-connections de servicio permanecen disponibles. Al especificar un recurso en la política de IAM, el prefijo del servicio debe coincidir con el del recurso.

Temas

• Público
• Autenticación con identidades
• Administración de acceso mediante políticas
• Cómo funcionan las características de la consola de herramientas para desarrolladores con IAM
• AWS CodeConnections referencia de permisos
• Ejemplos de políticas basadas en identidades
• Uso de etiquetas para controlar el acceso a AWS CodeConnections los recursos
• Uso de notificaciones y conexiones en la consola
• Permitir a los usuarios consultar sus propios permisos
• Solución de problemas: AWS CodeStar notificaciones, AWS CodeConnections identidad y acceso
• Uso de funciones vinculadas a servicios para las notificaciones AWS CodeStar
• Uso de roles vinculados a servicios de AWS CodeConnections
• AWS políticas gestionadas para AWS CodeConnections

Público

La forma de usar AWS Identity and Access Management (IAM) varía según el trabajo que se realice en AWS CodeStar Notificaciones y. AWS CodeConnections

Usuario del servicio: si utilizas las AWS CodeStar notificaciones y el AWS CodeConnections servicio para realizar tu trabajo, el administrador te proporcionará las credenciales y los permisos que necesitas. A medida que vaya utilizando más AWS CodeStar notificaciones y AWS CodeConnections funciones para realizar su trabajo, es posible que necesite permisos adicionales. Entender cómo se administra el acceso puede ayudarlo a solicitar los permisos correctos al administrador. Si no puede acceder a una función de AWS CodeStar las notificaciones y AWS CodeConnections, consulteSolución de problemas: AWS CodeStar notificaciones, AWS CodeConnections identidad y acceso.

Administrador de servicios: si está a cargo de AWS CodeStar las notificaciones y AWS CodeConnections los recursos de su empresa, probablemente tenga acceso completo a AWS CodeStar las notificaciones y AWS CodeConnections. Tu trabajo consiste en determinar a qué AWS CodeStar notificaciones, AWS CodeConnections funciones y recursos deben acceder los usuarios del servicio. Luego, debe enviar solicitudes a su administrador de IAM para cambiar los permisos de los usuarios de su servicio. Revise la información de esta página para conocer los conceptos básicos de IAM. Para obtener más información sobre cómo su empresa puede utilizar IAM con AWS CodeStar notificaciones AWS CodeConnections, consulteCómo funcionan las características de la consola de herramientas para desarrolladores con IAM.

Administrador de IAM: si es administrador de IAM, puede que desee obtener más información sobre cómo puede redactar políticas para administrar el acceso a AWS CodeStar las notificaciones y. AWS CodeConnections Para ver ejemplos de AWS CodeStar notificaciones y políticas AWS CodeConnections basadas en la identidad que puede utilizar en IAM, consulte. Ejemplos de políticas basadas en identidades

Autenticación con identidades

La autenticación es la forma de iniciar sesión AWS con sus credenciales de identidad. Debe estar autenticado (con quien haya iniciado sesión AWS) como usuario de IAM o asumiendo una función de IAM. Usuario raíz de la cuenta de AWS

Puede iniciar sesión AWS como una identidad federada mediante las credenciales proporcionadas a través de una fuente de identidad. AWS IAM Identity Center Los usuarios (Centro de identidades de IAM), la autenticación de inicio de sesión único de su empresa y sus credenciales de Google o Facebook son ejemplos de identidades federadas. Al iniciar sesión como una identidad federada, su administrador habrá configurado previamente la federación de identidades mediante roles de IAM. Cuando accedes AWS mediante la federación, estás asumiendo un rol de forma indirecta.

Según el tipo de usuario que sea, puede iniciar sesión en el portal AWS Management Console o en el de AWS acceso. Para obtener más información sobre cómo iniciar sesión AWS, consulte Cómo iniciar sesión Cuenta de AWS en su Guía del AWS Sign-In usuario.

Si accede AWS mediante programación, AWS proporciona un kit de desarrollo de software (SDK) y una interfaz de línea de comandos (CLI) para firmar criptográficamente sus solicitudes con sus credenciales. Si no utilizas AWS herramientas, debes firmar las solicitudes tú mismo. Para obtener más información sobre cómo usar el método recomendado para firmar las solicitudes usted mismo, consulte Firmar las solicitudes de la AWS API en la Guía del usuario de IAM.

Independientemente del método de autenticación que use, es posible que deba proporcionar información de seguridad adicional. Por ejemplo, le AWS recomienda que utilice la autenticación multifactor (MFA) para aumentar la seguridad de su cuenta. Para obtener más información, consulte Autenticación multifactor en la Guía del usuario de AWS IAM Identity Center y Uso de la autenticación multifactor (MFA) en AWSen la Guía del usuario de IAM.

Usuario raíz de la cuenta de AWS

Al crear una Cuenta de AWS, comienza con una identidad de inicio de sesión que tiene acceso completo a todos los recursos de Servicios de AWS la cuenta. Esta identidad se denomina usuario Cuenta de AWS raíz y se accede a ella iniciando sesión con la dirección de correo electrónico y la contraseña que utilizaste para crear la cuenta. Recomendamos encarecidamente que no utilice el usuario raíz para sus tareas diarias. Proteja las credenciales del usuario raíz y utilícelas solo para las tareas que solo el usuario raíz pueda realizar. Para ver la lista completa de las tareas que requieren que inicie sesión como usuario raíz, consulte Tareas que requieren credenciales de usuario raíz en la Guía del usuario de IAM.

Usuarios y grupos de IAM

Un usuario de IAM es una identidad propia Cuenta de AWS que tiene permisos específicos para una sola persona o aplicación. Siempre que sea posible, recomendamos emplear credenciales temporales, en lugar de crear usuarios de IAM que tengan credenciales de larga duración como contraseñas y claves de acceso. No obstante, si tiene casos de uso específicos que requieran credenciales de larga duración con usuarios de IAM, recomendamos rotar las claves de acceso. Para más información, consulte Rotar las claves de acceso periódicamente para casos de uso que requieran credenciales de larga duración en la Guía del usuario de IAM.

Un grupo de IAM es una identidad que especifica un conjunto de usuarios de IAM. No puede iniciar sesión como grupo. Puede usar los grupos para especificar permisos para varios usuarios a la vez. Los grupos facilitan la administración de los permisos de grandes conjuntos de usuarios. Por ejemplo, podría tener un grupo cuyo nombre fuese IAMAdmins y conceder permisos a dicho grupo para administrar los recursos de IAM.

Los usuarios son diferentes de los roles. Un usuario se asocia exclusivamente a una persona o aplicación, pero la intención es que cualquier usuario pueda asumir un rol que necesite. Los usuarios tienen credenciales permanentes a largo plazo y los roles proporcionan credenciales temporales. Para más información, consulte Cuándo crear un usuario de IAM (en lugar de un rol) en la Guía del usuario de IAM.

Roles de IAM

Un rol de IAM es una identidad dentro de usted Cuenta de AWS que tiene permisos específicos. Es similar a un usuario de IAM, pero no está asociado a una determinada persona. Puede asumir temporalmente una función de IAM en el AWS Management Console cambiando de función. Puede asumir un rol llamando a una operación de AWS API AWS CLI o utilizando una URL personalizada. Para más información sobre los métodos para el uso de roles, consulte Uso de roles de IAM en la Guía del usuario de IAM.

Los roles de IAM con credenciales temporales son útiles en las siguientes situaciones:

• Acceso de usuario federado: para asignar permisos a una identidad federada, puede crear un rol y definir sus permisos. Cuando se autentica una identidad federada, se asocia la identidad al rol y se le conceden los permisos define el rol. Para obtener información acerca de roles para federación, consulte Creación de un rol para un proveedor de identidades de terceros en la Guía del usuario de IAM. Si utiliza IAM Identity Center, debe configurar un conjunto de permisos. IAM Identity Center correlaciona el conjunto de permisos con un rol en IAM para controlar a qué pueden acceder las identidades después de autenticarse. Para obtener información acerca de los conjuntos de permisos, consulte Conjuntos de permisos en la Guía del usuario de AWS IAM Identity Center .

• Permisos de usuario de IAM temporales: un usuario de IAM puede asumir un rol de IAM para recibir temporalmente permisos distintos que le permitan realizar una tarea concreta.

• Acceso entre cuentas: puede utilizar un rol de IAM para permitir que alguien (una entidad principal de confianza) de otra cuenta acceda a los recursos de la cuenta. Los roles son la forma principal de conceder acceso entre cuentas. Sin embargo, con algunas Servicios de AWS, puedes adjuntar una política directamente a un recurso (en lugar de usar un rol como proxy). Para obtener información acerca de la diferencia entre los roles y las políticas basadas en recursos para el acceso entre cuentas, consulte Acceso a recursos entre cuentas en IAM en la Guía del usuario de IAM.

• Acceso entre servicios: algunos Servicios de AWS utilizan funciones en otros Servicios de AWS. Por ejemplo, cuando realiza una llamada en un servicio, es común que ese servicio ejecute aplicaciones en Amazon EC2 o almacene objetos en Amazon S3. Es posible que un servicio haga esto usando los permisos de la entidad principal, usando un rol de servicio o usando un rol vinculado al servicio.

  • Sesiones de acceso directo (FAS): cuando utilizas un usuario o un rol de IAM para realizar acciones en ellas AWS, se te considera director. Cuando utiliza algunos servicios, es posible que realice una acción que desencadene otra acción en un servicio diferente. El FAS utiliza los permisos del principal que llama Servicio de AWS y los solicita Servicio de AWS para realizar solicitudes a los servicios descendentes. Las solicitudes de FAS solo se realizan cuando un servicio recibe una solicitud que requiere interacciones con otros Servicios de AWS recursos para completarse. En este caso, debe tener permisos para realizar ambas acciones. Para obtener información sobre las políticas a la hora de realizar solicitudes de FAS, consulte Reenviar sesiones de acceso.

  • Rol de servicio: un rol de servicio es un rol de IAM que adopta un servicio para realizar acciones en su nombre. Un administrador de IAM puede crear, modificar y eliminar un rol de servicio desde IAM. Para obtener más información, consulte Creación de un rol para delegar permisos a un Servicio de AWS en la Guía del usuario de IAM.

  • Función vinculada al servicio: una función vinculada a un servicio es un tipo de función de servicio que está vinculada a un. Servicio de AWS El servicio puede asumir el rol para realizar una acción en su nombre. Los roles vinculados al servicio aparecen en usted Cuenta de AWS y son propiedad del servicio. Un administrador de IAM puede ver, pero no editar, los permisos de los roles vinculados a servicios.

• Aplicaciones que se ejecutan en Amazon EC2: puede usar un rol de IAM para administrar las credenciales temporales de las aplicaciones que se ejecutan en una instancia EC2 y realizan AWS CLI solicitudes a la API. AWS Es preferible hacerlo de este modo a almacenar claves de acceso en la instancia de EC2. Para asignar una AWS función a una instancia EC2 y ponerla a disposición de todas sus aplicaciones, debe crear un perfil de instancia adjunto a la instancia. Un perfil de instancia contiene el rol y permite a los programas que se ejecutan en la instancia de EC2 obtener credenciales temporales. Para más información, consulte Uso de un rol de IAM para conceder permisos a aplicaciones que se ejecutan en instancias Amazon EC2 en la Guía del usuario de IAM.

Para obtener información sobre el uso de los roles de IAM, consulte Cuándo crear un rol de IAM (en lugar de un usuario) en la Guía del usuario de IAM.

Administración de acceso mediante políticas

El acceso se controla AWS creando políticas y adjuntándolas a AWS identidades o recursos. Una política es un objeto AWS que, cuando se asocia a una identidad o un recurso, define sus permisos. AWS evalúa estas políticas cuando un director (usuario, usuario raíz o sesión de rol) realiza una solicitud. Los permisos en las políticas determinan si la solicitud se permite o se deniega. La mayoría de las políticas se almacenan AWS como documentos JSON. Para obtener más información sobre la estructura y el contenido de los documentos de política JSON, consulte Información general de políticas JSON en la Guía del usuario de IAM.

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.

De forma predeterminada, los usuarios y los roles no tienen permisos. Un administrador de IAM puede crear políticas de IAM para conceder permisos a los usuarios para realizar acciones en los recursos que necesitan. A continuación, el administrador puede añadir las políticas de IAM a roles y los usuarios pueden asumirlos.

Las políticas de IAM definen permisos para una acción independientemente del método que se utilice para realizar la operación. Por ejemplo, suponga que dispone de una política que permite la acción iam:GetRole. Un usuario con esa política puede obtener información sobre el rol de la API AWS Management Console AWS CLI, la o la AWS API.

Políticas basadas en identidades

Las políticas basadas en identidad son documentos de políticas de permisos JSON que puede asociar a una identidad, como un usuario de IAM, un grupo de usuarios o un rol. Estas políticas controlan qué acciones pueden realizar los usuarios y los roles, en qué recursos y en qué condiciones. Para obtener más información sobre cómo crear una política basada en identidad, consulte Creación de políticas de IAM en la Guía del usuario de IAM.

Las políticas basadas en identidades pueden clasificarse además como políticas insertadas o políticas administradas. Las políticas insertadas se integran directamente en un único usuario, grupo o rol. Las políticas administradas son políticas independientes que puede adjuntar a varios usuarios, grupos y roles de su Cuenta de AWS empresa. Las políticas administradas incluyen políticas AWS administradas y políticas administradas por el cliente. Para más información sobre cómo elegir una política administrada o una política insertada, consulte Elegir entre políticas administradas y políticas insertadas en la Guía del usuario de IAM.

AWS CodeConnections referencia de permisos

En las tablas siguientes se enumeran cada operación de la AWS CodeConnections API, las acciones correspondientes para las que puedes conceder permisos y el formato del ARN del recurso que se va a utilizar para conceder los permisos. Las AWS CodeConnections API se agrupan en tablas según el alcance de las acciones permitidas por esa API. Consulte esta tabla cuando escriba políticas de permisos que pueda adjuntar a una identidad de IAM (políticas basadas en identidad).

Al crear una política de permisos, debe especificar las acciones en el campo Actionde la política. Debe especificar un valor del recurso en el campo Resource de la política como ARN, con o sin un carácter comodín (*).

Para expresar condiciones en las políticas de conexiones, utilice las claves de condición descritas aquí y enumeradas en Claves de condición. También puedes usar claves AWS de condición generales. Para obtener una lista completa de las claves AWS de ancho, consulte las claves disponibles en la Guía del usuario de IAM.

Para especificar una acción, use el prefijo codeconnections seguido del nombre de la operación API (por ejemplo, codeconnections:ListConnections o codeconnections:CreateConnection).

Uso de comodines

Para especificar varias acciones o recursos, utilice el carácter de comodín (*) en el ARN. Por ejemplo, codeconnections:* especifica todas AWS CodeConnections las acciones y codeconnections:Get* especifica todas AWS CodeConnections las acciones que comienzan por la palabra. Get El siguiente ejemplo concede acceso a todos los recursos con nombres que comienzan con MyConnection.

arn:aws:codeconnections:us-west-2:account-ID:connection/*

Puede utilizar comodines solo con los recursos de connection que se muestran en la siguiente tabla. No puede utilizar comodines con los recursos region o account-id. Para obtener más información acerca de los comodines, consulte identificadores de IAM en la Guía del usuario de IAM.

Permisos para administrar conexiones

Un rol o usuario designado para usar el SDK AWS CLI o el SDK para ver, crear o eliminar conexiones debe tener permisos limitados a lo siguiente.

nota

No puede completar ni usar una conexión en la consola solo con los permisos siguientes. Debe agregar los permisos en Permisos para completar conexiones.

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections permisos necesarios para administrar las conexiones
AWS CodeConnections acciones	Permisos necesarios	Recursos
CreateConnection	codeconnections:CreateConnection Se necesita para utilizar la CLI o la consola para crear una conexión.	arn:aws:codeconnections: region: account-id: connection/ connection-id
DeleteConnection	codeconnections:DeleteConnection Se necesita para utilizar la CLI o la consola para eliminar una conexión.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
GetConnection	codeconnections:GetConnection Se necesita para utilizar la CLI o la consola para ver los detalles de una conexión.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
ListConnections	codeconnections:ListConnections Se necesita para utilizar la CLI o la consola para enumerar todas las conexiones de la cuenta.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id

Estas operaciones admiten las siguientes claves de condición:

Acción	Claves de condición
codeconnections:CreateConnection	codeconnections:ProviderType
codeconnections:DeleteConnection	N/A
codeconnections:GetConnection	N/A
codeconnections:ListConnections	codeconnections:ProviderTypeFilter

Permisos para administrar alojamientos

Un rol o usuario designado para usar el SDK AWS CLI o el SDK para ver, crear o eliminar hosts debe tener permisos limitados a lo siguiente.

nota

No puede completar ni utilizar una conexión en el alojamiento solo con los siguientes permisos. Debe agregar los permisos en Permisos para configurar alojamientos.

codeconnections:CreateHost
codeconnections:DeleteHost
codeconnections:GetHost
codeconnections:ListHosts

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections permisos necesarios para administrar los hosts
AWS CodeConnections acciones	Permisos necesarios	Recursos
CreateHost	codeconnections:CreateHost Se necesita para utilizar la CLI o la consola para crear un alojamiento.	arn:aws:codeconnections: region: account-id: host/ host-id
DeleteHost	codeconnections:DeleteHost Se necesita para utilizar la CLI o la consola para eliminar un alojamiento.	conexiones de código: región: id de cuenta: host/ host-id
GetHost	codeconnections:GetHost Se necesita para utilizar la CLI o la consola para ver los detalles de un alojamiento.	arn:aws:codeconnections: región: id de cuenta: host/ host-id
ListHosts	codeconnections:ListHosts Se necesita para utilizar la CLI o la consola para enumerar todos los alojamientos de la cuenta.	arn:aws:codeconnections: región: id de cuenta: host/ host-id

Estas operaciones admiten las siguientes claves de condición:

Acción	Claves de condición
codeconnections:CreateHost	codeconnections:ProviderType
codeconnections:DeleteHost	N/A
codeconnections:GetHost	N/A
codeconnections:ListHosts	codeconnections:ProviderTypeFilter

Permisos para completar conexiones

Un rol o un usuario designado para administrar conexiones en la consola debe tener los permisos necesarios para completar una conexión en la consola y crear una instalación, lo que incluye autorizar el protocolo de enlace al proveedor y crear instalaciones para que se utilicen las conexiones. Utilice los siguientes permisos además de los anteriores.

La consola utiliza las siguientes operaciones de IAM al realizar el protocolo de conexión basado en navegador. ListInstallationTargets, GetInstallationUrl, StartOAuthHandshake, UpdateConnectionInstallation y GetIndividualAccessToken son permisos de política de IAM. No son acciones de API.

codeconnections:GetIndividualAccessToken
codeconnections:GetInstallationUrl
codeconnections:ListInstallationTargets
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation

En función de esto, se necesitan los siguientes permisos para utilizar, crear, actualizar o eliminar una conexión en la consola.

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections
codeconnections:UseConnection
codeconnections:ListInstallationTargets
codeconnections:GetInstallationUrl
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation
codeconnections:GetIndividualAccessToken

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections permisos necesarios para completar las conexiones
AWS CodeConnections acciones	Permisos necesarios	Recursos
GetIndividualAccessToken	codeconnections:GetIndividualAccessToken Se necesita para utilizar la consola para completar una conexión. Se trata únicamente de un permiso de política de IAM, no de una acción de API.	arn:aws:codeconnections: region: account-id: connection/ connection-id
GetInstallationUrl	codeconnections:GetInstallationUrl Se necesita para utilizar la consola para completar una conexión. Se trata únicamente de un permiso de política de IAM, no de una acción de API.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
ListInstallationTargets	codeconnections:ListInstallationTargets Se necesita para utilizar la consola para completar una conexión. Se trata únicamente de un permiso de política de IAM, no de una acción de API.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
StartOAuthHandshake	codeconnections:StartOAuthHandshake Se necesita para utilizar la consola para completar una conexión. Se trata únicamente de un permiso de política de IAM, no de una acción de API.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
UpdateConnectionInstallation	codeconnections:UpdateConnectionInstallation Se necesita para utilizar la consola para completar una conexión. Se trata únicamente de un permiso de política de IAM, no de una acción de API.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id

Estas operaciones admiten las siguientes claves de condición.

Acción	Claves de condición
codeconnections:GetIndividualAccessToken	codeconnections:ProviderType
codeconnections:GetInstallationUrl	codeconnections:ProviderType
codeconnections:ListInstallationTargets	N/A
codeconnections:StartOAuthHandshake	codeconnections:ProviderType
codeconnections:UpdateConnectionInstallation	codeconnections:InstallationId

Permisos para configurar alojamientos

Un rol o un usuario designado para administrar conexiones en la consola debe tener los permisos necesarios para configurar un alojamiento en la consola, lo que incluye la autorización del protocolo de enlace al proveedor y la instalación de la aplicación del alojamiento. Utilice los siguientes permisos además de los permisos para alojamientos anteriores.

La consola utiliza las siguientes operaciones de IAM cuando realiza el registro de alojamiento basado en navegador. RegisterAppCode y StartAppRegistrationHandshake son permisos de política de IAM. No son acciones de API.

codeconnections:RegisterAppCode
codeconnections:StartAppRegistrationHandshake

En función de esto, se necesitan los siguientes permisos para utilizar, crear, actualizar o eliminar una conexión en la consola que requiere un alojamiento (como, por ejemplo, tipos de proveedor instalados).

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections
codeconnections:UseConnection
codeconnections:ListInstallationTargets
codeconnections:GetInstallationUrl
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation
codeconnections:GetIndividualAccessToken
codeconnections:RegisterAppCode
codeconnections:StartAppRegistrationHandshake

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections permisos necesarios para completar la configuración del host
Acciones de conexiones	Permisos necesarios	Recursos
RegisterAppCode	codeconnections:RegisterAppCode Se necesita para utilizar la consola para completar la configuración del alojamiento. Se trata únicamente de un permiso de política de IAM, no de una acción de API.	arn:aws:codeconnections: region: account-id: host/ host-id
StartAppRegistrationHandshake	codeconnections:StartAppRegistrationHandshake Se necesita para utilizar la consola para completar la configuración del alojamiento. Se trata únicamente de un permiso de política de IAM, no de una acción de API.	arn:aws:codeconnections: región: id de cuenta: host/ host-id

Estas operaciones admiten las siguientes claves de condición.

Pasar una conexión a un servicio

Cuando se pasa una conexión a un servicio (por ejemplo, cuando se proporciona un ARN de conexión en una definición de canalización para crear o actualizar una canalización), el usuario debe tener el permiso codeconnections:PassConnection.

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections permisos necesarios para transferir una conexión
AWS CodeConnections acciones	Permisos necesarios	Recursos
PassConnection	codeconnections:PassConnection Se necesita para pasar una conexión a un servicio.	arn:aws:codeconnections: region: account-id: connection/ connection-id

Esta operación también admite la siguiente clave de condición:

• codeconnections:PassedToService

Valores admitidos para claves de condición
Clave	Proveedores válidos de la acción
codeconnections:PassedToService	codeguru-reviewer codepipeline.amazonaws.com proton.amazonaws.com

Uso de una conexión

Cuando un servicio como este CodePipeline usa una conexión, el rol del servicio debe tener el codeconnections:UseConnection permiso para una conexión determinada.

Para administrar las conexiones en la consola, la política de usuario debe tener el permiso codeconnections:UseConnection.

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections acción necesaria para utilizar las conexiones
AWS CodeConnections acciones	Permisos necesarios	Recursos
UseConnection	codeconnections:UseConnection Se necesita para utilizar una conexión.	arn:aws:codeconnections: region: account-id: connection/ connection-id

Esta operación también admite las siguientes claves de condición:

• codeconnections:BranchName

• codeconnections:FullRepositoryId

• codeconnections:OwnerId

• codeconnections:ProviderAction

• codeconnections:ProviderPermissionsRequired

• codeconnections:RepositoryName

Valores admitidos para claves de condición
Clave	Proveedores válidos de la acción
codeconnections:FullRepositoryId	Nombre de usuario y nombre de repositorio de un repositorio, como my-owner/my-repository. Se admite solo cuando la conexión se utiliza para obtener acceso a un repositorio específico.
codeconnections:ProviderPermissionsRequired	read_only o read_write
codeconnections:ProviderAction	GetBranch, ListRepositories, ListOwners, ListBranches, StartUploadArchiveToS3, GitPush, GitPull, GetUploadArchiveToS3Status, CreatePullRequestDiffComment, GetPullRequest, ListBranchCommits, ListCommitFiles, ListPullRequestComments, ListPullRequestCommits. Para obtener información, consulte la siguiente sección.

Las claves de condición necesarias para algunas funciones pueden cambiar con el tiempo. Es recomendable que utilice codeconnections:UseConnection para controlar el acceso a una conexión, a menos que sus requisitos de control de acceso requieran permisos diferentes.

Tipos de acceso admitidos para ProviderAction

Cuando un AWS servicio utiliza una conexión, se realizan llamadas a la API a su proveedor de código fuente. Por ejemplo, un servicio puede mostrar los repositorios para una conexión de Bitbucket llamando a la API https://api.bitbucket.org/2.0/repositories/username.

La clave de condición ProviderAction le permite restringir las API de un proveedor a las que se puede llamar. Como la ruta de la API se puede generar de forma dinámica y varía de un proveedor a otro, el valor ProviderAction se mapea a un nombre de acción abstracto en lugar de a la URL de la API. Esto le permite escribir políticas que tengan el mismo efecto independientemente del tipo de proveedor de la conexión.

A continuación, se encuentran los tipos de acceso que se conceden para cada uno de los valores ProviderAction admitidos. A continuación, se presentan permisos de política de IAM. No son acciones de API.

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections tipos de acceso compatibles para ProviderAction
AWS CodeConnections permiso	Permisos necesarios	Recursos
GetBranch	codeconnections:GetBranch Se necesita para acceder a la información sobre una ramificación, como, por ejemplo, la última confirmación de esa ramificación.	arn:aws:codeconnections: region: account-id: connection/ connection-id
ListRepositories	codeconnections:ListRepositories Se necesita para acceder a una lista de repositorios públicos y privados, incluidos los detalles de esos repositorios, que pertenecen a un propietario.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
ListOwners	codeconnections:ListOwners Se necesita para acceder a una lista de propietarios a los que la conexión tiene acceso.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
ListBranches	codeconnections:ListBranches Se necesita para acceder a la lista de ramificaciones que existen en un repositorio determinado.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
StartUploadArchiveToS3	codeconnections:StartUploadArchiveToS3 Se necesita para leer el código fuente y cargarlo en Amazon S3.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
GitPush	codeconnections:GitPush Se necesita para escribir en un repositorio con Git.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
GitPull	codeconnections:GitPull Se necesita para leer desde un repositorio con Git.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
GetUploadArchiveToS3Status	codeconnections:GetUploadArchiveToS3Status Se necesita para acceder al estado de una carga, incluidos los mensajes de error, iniciada por StartUploadArchiveToS3.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
CreatePullRequestDiffComment	codeconnections:CreatePullRequestDiffComment Se necesita para acceder a los comentarios de una solicitud de extracción.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
GetPullRequest	codeconnections:GetPullRequest Se necesita para ver las solicitudes de extracción de un repositorio.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
ListBranchCommits	codeconnections:ListBranchCommits Se necesita para ver una lista de confirmaciones de una ramificación de repositorio.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
ListCommitFiles	codeconnections:ListCommitFiles Se necesita para ver una lista de archivos de una confirmación.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
ListPullRequestComments	codeconnections:ListPullRequestComments Se necesita para ver una lista de comentarios de una solicitud de extracción.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id
ListPullRequestCommits	codeconnections:ListPullRequestCommits Se necesita para ver una lista de confirmaciones de una solicitud de extracción.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id

Permisos compatibles con el etiquetado de recursos de conexión

Las siguientes operaciones de IAM se utilizan al etiquetar los recursos de conexión.

codeconnections:ListTagsForResource
codeconnections:TagResource
codeconnections:UntagResource

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections acciones necesarias para etiquetar los recursos de conexión
AWS CodeConnections acciones	Permisos necesarios	Recursos
ListTagsForResource	codeconnections:ListTagsForResource Se necesita para ver una lista de etiquetas asociadas al recurso de conexión.	arn:aws:codeconnections: region: account-id: connection/ connection-id , arn:aws:codeconnections: región: id de cuenta: host/ host-id
TagResource	codeconnections:TagResource Se necesita para etiquetar un recurso de conexión.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id , arn:aws:codeconnections: región: id de cuenta: host/ host-id
UntagResource	codeconnections:UntagResource Se necesita para eliminar etiquetas de un recurso de conexión.	arn:aws:codeconnections: región: id de cuenta: connection/ connection-id , arn:aws:codeconnections: región: id de cuenta: host/ host-id

Pasar una conexión a un enlace de repositorio

Cuando se proporciona un enlace al repositorio en una configuración de sincronización, el usuario debe tener el permiso codeconnections:PassRepository para el ARN o recurso del enlace al repositorio.

Utilice las barras de desplazamiento para ver el resto de la tabla.

AWS CodeConnections permisos necesarios para transferir una conexión
AWS CodeConnections acciones	Permisos necesarios	Recursos
PassRepository	codeconnections:PassRepository Necesario para pasar un enlace de repositorio a una configuración de sincronización.	arn:aws:codeconnections: region: account-id: repository-link/ repository-link-id

Esta operación también admite la siguiente clave de condición:

• codeconnections:PassedToService

Valores admitidos para claves de condición
Clave	Proveedores válidos de la acción
codeconnections:PassedToService	cloudformation.sync.codeconnections.amazonaws.com

Clave de condición compatible para los enlaces de repositorios

La siguiente clave de condición admite las operaciones de los enlaces de repositorio y los recursos de configuración de sincronización:

• codeconnections:Branch

  Filtra el acceso por el nombre de ramificación que se incluye en la solicitud.

Acciones compatibles con la clave de condición
Clave	Valores válidos
codeconnections:Branch	Esta clave de condición admite las siguientes acciones: CreateSyncConfiguration UpdateSyncConfiguration GetRepositorySyncStatus

Uso de notificaciones y conexiones en la consola

La experiencia de notificaciones está integrada en las CodePipeline consolas CodeBuild CodeCommit, CodeDeploy, y, además, en la consola Developer Tools, situada en la propia barra de navegación de configuración. Para tener acceso a las notificaciones de las consolas, debe tener aplicada una de las políticas administradas para esos servicios o tener un conjunto mínimo de permisos. Estos permisos deben permitirte enumerar y ver detalles sobre las AWS CodeStar notificaciones y AWS CodeConnections los recursos de tu AWS cuenta. Si crea una política basada en identidad que sea más restrictiva que el mínimo de permisos necesarios, la consola no funcionará del modo esperado para las entidades (usuarios o roles de IAM) que tengan esa política. Para obtener más información sobre la concesión de acceso a AWS CodeBuild AWS CodeCommit AWS CodeDeploy,, y AWS CodePipeline, incluido el acceso a esas consolas, consulta los siguientes temas:

• CodeBuild: Utilizar políticas basadas en la identidad para CodeBuild

• CodeCommit: Utilizar políticas basadas en la identidad para CodeCommit

• AWS CodeDeploy: Gestión de identidad y acceso para AWS CodeDeploy

• CodePipeline: Control de acceso con políticas de IAM

AWS CodeStar Las notificaciones no tienen políticas AWS gestionadas. Para proporcionar acceso a la funcionalidad de notificación, debe aplicar una de las políticas administradas para uno de los servicios enumerados anteriormente o debe crear políticas con el nivel de permiso que desea conceder a los usuarios o entidades y, luego, adjuntar esas políticas a los usuarios, los grupos o los roles que necesitan esos permisos. Para obtener más información y ejemplos, consulte lo siguiente:

• Ejemplo: una política a nivel de administrador para gestionar las notificaciones AWS CodeStar

• Ejemplo: una política a nivel de colaborador para usar las notificaciones AWS CodeStar

• Ejemplo: una read-only-level política para usar AWS CodeStar las notificaciones.

AWS CodeConnections no tiene ninguna política AWS gestionada. Utilice los permisos y las combinaciones de permisos de acceso, como los permisos detallados en Permisos para completar conexiones.

Para más información, consulte los siguientes temas:

• Ejemplo: una política de administración a nivel de administrador AWS CodeConnections

• Ejemplo: una política de uso a nivel de colaborador AWS CodeConnections

• Ejemplo: una read-only-level política de uso AWS CodeConnections

No es necesario que concedas permisos de consola a los usuarios que solo realizan llamadas a la API AWS CLI o a la AWS API. En su lugar, permite acceso únicamente a las acciones que coincidan con la operación de API que intenta realizar.

Permitir a los usuarios consultar 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 AWS CLI o 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": "*"
        }
    ]
}