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.

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

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. IAMlos administradores controlan quién puede autenticarse (iniciar sesión) y quién está autorizado (tiene permisos) para usar AWS CodeStar las notificaciones y AWS CodeConnections los recursos. IAMes una Servicio de AWS que puede utilizar sin coste adicional.

Público

La forma de usar AWS Identity and Access Management (IAM) varía según el trabajo que realices 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 de AWS CodeStar notificaciones e 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. A continuación, debe enviar solicitudes a su IAM administrador para cambiar los permisos de los usuarios del servicio. Revise la información de esta página para comprender los conceptos básicos deIAM. Para obtener más información sobre cómo su empresa puede utilizar IAM las AWS CodeStar notificaciones y AWS CodeConnections, consulteCómo funcionan las funciones de la consola de herramientas para desarrolladores con IAM.

IAMadministrador: si es IAM administrador, 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 utilizarIAM, 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 IAM usuario o asumiendo un IAM rol. 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 (IAMIdentity Center), 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, el administrador configuró previamente la federación de identidades mediante roles. IAM Cuando accede AWS mediante la federación, asume indirectamente un rol.

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 incluye 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 AWS API las solicitudes en la Guía del IAM usuario.

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 multifactorial (MFA) para aumentar la seguridad de su cuenta. Para obtener más información, consulte Autenticación multifactorial en la Guía del AWS IAM Identity Center usuario y Uso de la autenticación multifactorial (MFA) AWS en la Guía del IAM usuario.

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 Servicios de AWS de 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 tareas que requieren que inicie sesión como usuario root, consulte Tareas que requieren credenciales de usuario root en la Guía del IAM usuario.

Usuarios y grupos de IAM

Un IAMusuario es una identidad propia Cuenta de AWS que tiene permisos específicos para una sola persona o aplicación. Siempre que sea posible, recomendamos utilizar credenciales temporales en lugar de crear IAM usuarios con credenciales de larga duración, como contraseñas y claves de acceso. Sin embargo, si tiene casos de uso específicos que requieren credenciales a largo plazo con IAM los usuarios, le recomendamos que rote las claves de acceso. Para obtener más información, consulte Rotar las claves de acceso con regularidad para los casos de uso que requieran credenciales de larga duración en la Guía del IAM usuario.

Un IAMgrupo es una identidad que especifica un conjunto de IAM usuarios. 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 para grandes conjuntos de usuarios. Por ejemplo, puede asignar un nombre a un grupo IAMAdminsy concederle permisos para administrar IAM los recursos.

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 de larga duración permanentes; no obstante, los roles proporcionan credenciales temporales. Para obtener más información, consulte Cuándo crear un IAM usuario (en lugar de un rol) en la Guía del IAM usuario.

Roles de IAM

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

IAMlos roles con credenciales temporales son útiles en las siguientes situaciones:

Para saber si se deben usar IAM roles o IAM usuarios, consulte Cuándo crear un IAM rol (en lugar de un usuario) en la Guía del IAM usuario.

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 JSON documentos. Para obtener más información sobre la estructura y el contenido de los documentos de JSON políticas, consulte Descripción general de JSON las políticas en la Guía del IAM usuario.

Los administradores pueden usar AWS JSON las políticas 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. Para conceder a los usuarios permiso para realizar acciones en los recursos que necesitan, un IAM administrador puede crear IAM políticas. A continuación, el administrador puede añadir las IAM políticas a las funciones y los usuarios pueden asumir las funciones.

IAMlas políticas definen los 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 AWS Management Console AWS CLI, el o el AWS API.

Políticas basadas en identidad

Las políticas basadas en la identidad son documentos de política de JSON permisos que se pueden adjuntar a una identidad, como un IAM usuario, 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 información sobre cómo crear una política basada en la identidad, consulte Creación de IAM políticas en la Guía del usuario. 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 funciones de su empresa. Cuenta de AWS Las políticas administradas incluyen políticas AWS administradas y políticas administradas por el cliente. Para saber cómo elegir entre una política gestionada o una política integrada, consulte Elegir entre políticas gestionadas y políticas integradas en la Guía del IAM usuario.

AWS CodeConnections referencia de permisos

En las tablas siguientes se enumeran cada AWS CodeConnections API operación, las acciones correspondientes para las que puede conceder permisos y el formato del recurso que se va ARN a utilizar para conceder los permisos. AWS CodeConnections APIsSe agrupan en tablas según el alcance de las acciones que permitenAPI. Consúltela cuando redacte políticas de permisos que pueda adjuntar a una IAM identidad (políticas basadas en la identidad).

Al crear una política de permisos, debe especificar las acciones en el campo Actionde la política. El valor del recurso se especifica en el Resource campo de la política comoARN, 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 puede utilizar claves AWS de condición amplias. Para obtener una lista completa de las teclas AWS de ancho ancho, consulte las teclas disponibles en la Guía del IAMusuario.

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

Uso de comodines

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

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

Solo puede utilizar caracteres comodín con la connection los recursos que se muestran en la siguiente tabla. No puede utilizar caracteres comodín con region o account-id recursos. Para obtener más información sobre los comodines, consulte los IAMidentificadores en la Guía IAMdel usuario.

Permisos para administrar conexiones

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

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

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

Estas operaciones admiten las siguientes claves de condición:

Permisos para administrar alojamientos

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

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

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

Estas operaciones admiten las siguientes claves de condición:

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 IAM las siguientes operaciones al realizar un apretón de manos basado en el navegador. LosListInstallationTargets, GetInstallationUrlStartOAuthHandshake, y GetIndividualAccessToken son UpdateConnectionInstallation IAM permisos de política. No son API acciones.

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.

Estas operaciones admiten las siguientes claves de condición.

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 IAM las siguientes operaciones al realizar un registro de host basado en un navegador. RegisterAppCodey StartAppRegistrationHandshake son permisos de IAM política. No son API acciones.

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.

Estas operaciones admiten las siguientes claves de condición.

Pasar una conexión a un servicio

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

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

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

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.

Esta operación también admite las siguientes claves de condició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 API llamadas a su proveedor de código fuente. Por ejemplo, un servicio puede mostrar los repositorios de una conexión de Bitbucket llamando al. https://api.bitbucket.org/2.0/repositories/username API

La clave de ProviderAction condición te permite restringir a qué APIs proveedor se puede llamar. Como la API ruta se puede generar de forma dinámica y la ruta varía de un proveedor a otro, el ProviderAction valor se asigna a un nombre de acción abstracto y no al nombre URL delAPI. 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. Los siguientes son permisos IAM de política. No son API acciones.

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

Permisos compatibles con el etiquetado de recursos de conexión

Las siguientes IAM operaciones 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.

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 codeconnections:PassRepository permiso para el enlace al repositorio /resource. ARN

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

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

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:

Uso de notificaciones y conexiones en la consola

La experiencia de notificaciones está integrada en las CodePipeline consolas CodeBuild CodeCommit, CodeDeploy, y también 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 creas una política basada en la identidad que sea más restrictiva que los permisos mínimos requeridos, la consola no funcionará según lo previsto para las entidades (IAMusuarios o roles) que cuenten con esa política. Para obtener más información sobre cómo conceder acceso a esas consolas e AWS CodeBuild AWS CodeCommit AWS CodeDeploy AWS CodePipeline, incluido el acceso a ellas, consulte los siguientes temas:

AWS CodeStar Las notificaciones no tienen ninguna política AWS gestionada. 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:

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:

No es necesario conceder permisos de consola a los usuarios que realizan llamadas únicamente al AWS CLI o al AWS API. En su lugar, permita el acceso únicamente a las acciones que coincidan con la API operación que está intentando realizar.

Cómo permitir a los usuarios consultar sus propios permisos

En este ejemplo, se muestra cómo se puede crear una política que permita a IAM los usuarios ver las políticas integradas y administradas asociadas a su identidad de usuario. Esta política incluye permisos para completar esta acción en la consola o mediante programación mediante la tecla o. AWS CLI AWS API

{
    "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": "*"
        }
    ]
}