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.
Simplificado Servicio de AWS información para el acceso programático
AWS proporciona información de referencia de servicios en formato JSON para agilizar la automatización de los flujos de trabajo de administración de políticas. Con la información de referencia del servicio, puede acceder a las operaciones, las acciones, los recursos y las claves de condición disponibles en todas partes Servicios de AWS desde archivos legibles por máquinas. La información de referencia del servicio incluye metadatos más allá de los detalles de autorización, incluida la información sobre la acción de IAM a la que se accedió por última vez y los datos de generación de políticas de IAM Access Analyzer.
Los administradores de seguridad pueden establecer barreras y los desarrolladores pueden garantizar el acceso adecuado a las aplicaciones identificando las acciones, los recursos y las claves de condición disponibles para cada una Servicio de AWS. AWS proporciona información de referencia de servicio para Servicios de AWS para permitirle incorporar los metadatos en sus flujos de trabajo de administración de políticas.
AWS también proporciona una lista consolidada de claves de condición globales que se aplican en Servicios de AWS. Puedes descubrir el aws:-claves con prefijo disponibles para su uso en las políticas de IAM de cualquier servicio desde un único archivo legible por máquina.
-
Para obtener un inventario de acciones, recursos y claves de condición para su uso en las políticas de IAM, consulte la página de Referencia de autorización del servicio para el Servicio de AWS. Las acciones, los recursos y las claves de condición de servicios que comparten un prefijo de servicio pueden estar divididos en varias páginas de la Referencia de autorización del servicio.
-
Para obtener una lista de Servicios de AWS y las acciones en las que se muestra la información a la que se accedió por última vez a la acción de IAM, consulte Acción de IAM: información, servicios y acciones a los que se accedió por última vez en la Guía del usuario de IAM.
-
Para obtener una lista de Servicios de AWS y las acciones para las que IAM Access Analyzer genera políticas con información a nivel de acción, consulte Servicios de generación de políticas de IAM Access Analyzer en la Guía del usuario de IAM.
El contenido que se incluye en la Referencia de autorización del servicio puede presentarse de forma diferente o contener metadatos distintos. Para obtener más información, consulte Definiciones de campos adicionales.
La información de referencia del servicio también ofrece metadatos sobre las operaciones, incluida la información sobre las acciones autorizadas y los nombres de los métodos en los SDK.
Es posible que esté disponible un contexto adicional sobre el valor de las claves de condición para ayudar a determinar el alcance de los permisos. Por ejemplo, el valor de iam:PassedToService puede aparecer cuando se realiza la acción iam:PassRole está autorizado por una operación.
Este mapeo entre la operación y la acción no es compatible con todos los servicios. Los servicios que aún no admitan este mapeo omitirán el AuthorizedAction propiedad. Además, la información sobre las acciones autorizadas para las operaciones no incluye los permisos que podrían ser necesarios para las operaciones que se realicen en su nombre con Sesiones de acceso directo.
Es posible que los cambios en la información de referencia del servicio tarden hasta 24 horas en reflejarse en la lista de metadatos para el servicio.
Acceso Servicio de AWS información de referencia
-
Navegue hasta la información de referencia del servicio para acceder a la lista de Servicios de AWS para los que está disponible la información de referencia.
Hay tres puntos de entrada principales:
https://servicereference.us-east-1.amazonaws.com/
muestra una lista de Servicios de AWS para el que está disponible la información de referencia. El siguiente ejemplo muestra una lista parcial de servicios y URL para su respectiva información de referencia:
[ { "service": "s3", "url": "https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json" }, { "service": "dynamodb", "url": "https://servicereference.us-east-1.amazonaws.com/v1/dynamodb/dynamodb.json" }, … ]https://servicereference.us-east-1.amazonaws.com/v1/global-condition-keys.json
muestra las claves de condición globales que puede usar en las políticas de IAM en todas partes Servicios de AWS. El siguiente ejemplo muestra una lista parcial de claves de condición globales:
[ { "Name" : "aws:AssumedRoot", "Description" : "Filters access based on whether the request was made using temporary security credentials for AssumeRoot", "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html", "Types" : [ "Bool" ] }, { "Name" : "aws:CalledVia", "Description" : "Filters access by the services that make the request on behalf of the IAM principal", "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-calledvia", "Types" : [ "ArrayOfString" ] }, { "Name" : "aws:ChatbotSourceArn", "Description" : "This key identifies the chatbot configuration ARN associated with the assume role session initiated by AWS Chatbot.", "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-chatbotsourcearn", "Types" : [ "ARN", "String" ] }, { "Name" : "aws:CurrentTime", "Description" : "Filters access by the time and date when the request was made", "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-currenttime", "Types" : [ "Date" ] } ]https://servicereference.us-east-1.amazonaws.com/v1/mapping.json
muestra una asignación de los servicios del SDK a la ubicación de la referencia del servicio en la que se encuentra la información. En el siguiente ejemplo, se muestra una lista parcial de mapeos:
{ "SDK" : { "Python" : { "Boto3" : { "accessanalyzer" : { "service" : "access-analyzer", "url" : "https://servicereference.us-east-1.amazonaws.com/v1/access-analyzer/access-analyzer.json" }, "account" : { "service" : "account", "url" : "https://servicereference.us-east-1.amazonaws.com/v1/account/account.json" }, "amp" : { "service" : "aps", "url" : "https://servicereference.us-east-1.amazonaws.com/v1/aps/aps.json" }, ... } } } } -
Elija un servicio y vaya a la página de información del servicio en el campo
urlcorrespondiente para ver una lista de acciones, recursos y claves de condición para el servicio.El siguiente ejemplo muestra una lista parcial de información de referencia del servicio de Amazon S3:
{ "Name": "s3", "ServiceName": "S3", "Actions": [ { "Name": "GetObject", "ActionConditionKeys": [ "s3:AccessGrantsInstanceArn", "s3:AccessPointNetworkOrigin", "s3:DataAccessPointAccount", "s3:DataAccessPointArn", "s3:ExistingObjectTag/key", "s3:ResourceAccount", "s3:TlsVersion", "s3:authType", "s3:if-match", "s3:if-none-match", "s3:signatureAge", "s3:signatureversion", "s3:x-amz-content-sha256" ], "Annotations" : { "Properties" : { "IsDataPlane" : true, "IsList" : false, "IsPermissionManagement" : false, "IsTaggingOnly" : false, "IsWrite" : false } }, "Resources": [ { "Name": "object" } ], "SupportedBy" : { "IAM Access Analyzer Policy Generation" : false, "IAM Action Last Accessed" : false } }, { "Name": "ListBucket", "ActionConditionKeys": [ "s3:AccessGrantsInstanceArn", "s3:AccessPointNetworkOrigin", "s3:DataAccessPointAccount", "s3:DataAccessPointArn", "s3:ResourceAccount", "s3:TlsVersion", "s3:authType", "s3:delimiter", "s3:max-keys", "s3:prefix", "s3:signatureAge", "s3:signatureversion", "s3:x-amz-content-sha256" ], "Annotations" : { "Properties" : { "IsDataPlane" : true, "IsList" : true, "IsPermissionManagement" : false, "IsTaggingOnly" : false, "IsWrite" : false } }, "Resources": [ { "Name": "bucket" } ], "SupportedBy" : { "IAM Access Analyzer Policy Generation" : false, "IAM Action Last Accessed" : false } }, ... ], "ConditionKeys": [ { "Name": "s3:TlsVersion", "Types": [ "Numeric" ] }, { "Name": "s3:authType", "Types": [ "String" ] }, ... ], "Operations": [ { "Name" : "GetObject", "AuthorizedActions" : [ { "Name" : "GetObject", "Service" : "s3" }, { "Name" : "GetObject", "Service" : "s3-object-lambda" }, { "Name" : "GetObjectLegalHold", "Service" : "s3" }, { "Name" : "GetObjectRetention", "Service" : "s3" }, { "Name" : "GetObjectTagging", "Service" : "s3" }, { "Name" : "GetObjectVersion", "Service" : "s3" } ], "SDK" : [ { "Name" : "s3", "Method" : "get_object", "Package" : "Boto3" } ] }, ... ], "Resources": [ { "Name": "accesspoint", "ARNFormats": [ "arn:${Partition}:s3:${Region}:${Account}:accesspoint/${AccessPointName}" ] }, { "Name": "bucket", "ARNFormats": [ "arn:${Partition}:s3:::${BucketName}" ] } ... ], "Version": "v1.5" }El
ServiceNameel campo proporciona un nombre legible para el usuario Servicio de AWS, comoS3para els3servicio. Aparece en el nivel superior del archivo de referencia del servicio, inmediatamente después delNamecampo. -
Descargue el archivo JSON de la URL del servicio para utilizarlo en los flujos de trabajo de creación de políticas.
Glosario
-
Operación: una API a la que se puede llamar, normalmente a través de un SDK
-
Acción: permiso que se autoriza al realizar una operación
Definiciones de campos adicionales
Las propiedades de las acciones proporcionan metadatos adicionales sobre las acciones del servicio para ayudar a clasificarlas en función del alcance de sus permisos. Estas propiedades se encuentran en el campo Annotations de cada acción. Los metadatos constan de cinco valores booleanos:
-
IsDataPlane— Indica que la acción se basa en los datos o el contenido de un recurso, en lugar de crear, configurar o administrar el recurso en sí. Esta propiedad se deriva de AWS CloudTrail categorías de eventos de las operaciones que autorizan la acción.Ejemplo — Esta propiedad es
truepara el Amazon S3GetObjectacción, que lee el contenido del objeto, yfalseporCreateBucket, que crea y configura el recurso (una operación del plano de control).Algunas acciones omiten esta propiedad. Una acción conlleva
IsDataPlanesolo cuando al menos una operación que la autoriza tiene un CloudTrail categoría de evento. Si la propiedad no existe, significa que la acción aún no está clasificada. -
IsList— Indica que la acción descubre y enumera los recursos, incluidos los metadatos básicos, sin acceder al contenido de los recursos.Ejemplo — Esta propiedad es
truepara el Amazon S3ListBucketaction, que devuelve listados de cubos sin acceder a los objetos en sí. -
IsPermissionManagement— Indica que la acción puede modificar los permisos de IAM o las credenciales de acceso.Ejemplo — Esta propiedad es
truepara la mayoría de IAM y AWS Organizations y para Amazon S3, acciones comoPutBucketPolicyyDeleteBucketPolicy. -
IsTaggingOnly— Indica que la acción solo modifica las etiquetas.Ejemplo — Esta propiedad es
truepara las acciones de IAMTagRoleyUntagRole, yfalseporCreateRole, que otorga permisos más amplios más allá del etiquetado. -
IsWrite— Indica que la acción puede modificar los recursos, lo que puede incluir modificaciones en las etiquetas.Ejemplo — Esta propiedad es
truepara las acciones de Amazon S3CreateBucket,DeleteBucket, yPutObject, que modifican los recursos.
Estas propiedades no se excluyen mutuamente. Una acción puede tener varias propiedades configuradas en true.
También es posible que todas las propiedades sean false, como se ve en la acción GetBucketPolicy de Amazon S3. Esto indica que la acción solo otorga permisos de lectura en la configuración del bucket.
Estas propiedades se pueden utilizar para generar información sobre los servicios. En el siguiente ejemplo, se muestra qué permisos con el prefijo s3 permiten mutar los recursos:
> curl https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json | \ jq '.Actions[] | select(.Annotations.Properties.IsWrite == true) | .Name' "AssociateAccessGrantsIdentityCenter" "BypassGovernanceRetention" "CreateAccessGrant" "CreateAccessGrantsInstance" "CreateAccessGrantsLocation" ...
El siguiente ejemplo muestra qué permisos tienen el s3 el prefijo otorga acceso a los datos en lugar de a la configuración del servicio:
> curl https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json | \ jq '.Actions[] | select(.Annotations.Properties.IsDataPlane == true) | .Name' "AbortMultipartUpload" "BypassGovernanceRetention" "DeleteObject" "DeleteObjectVersion" "GetObject" ...
En el siguiente ejemplo, se muestran las claves de condición de acción con el prefijo lambda que puede utilizar para limitar el acceso a las acciones de administración de permisos:
> curl https://servicereference.us-east-1.amazonaws.com/v1/lambda/lambda.json | \ jq '.Actions[] | select(.Annotations.Properties.IsPermissionManagement == true) | {Name: .Name, ActionConditionKeys: (.ActionConditionKeys // [])}' { "Name": "AddLayerVersionPermission", "ActionConditionKeys": [] } { "Name": "AddPermission", "ActionConditionKeys": [ "lambda:FunctionUrlAuthType", "lambda:Principal" ] } { "Name": "DisableReplication", "ActionConditionKeys": [] } { "Name": "EnableReplication", "ActionConditionKeys": [] } { "Name": "RemoveLayerVersionPermission", "ActionConditionKeys": [] } { "Name": "RemovePermission", "ActionConditionKeys": [ "lambda:FunctionUrlAuthType", "lambda:Principal" ] }