View a markdown version of this page

Agregar AWS Config Reglas - AWS Config

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.

Agregar AWS Config Reglas

Puede utilizar el AWS Config consola o el AWS SDK para añadir reglas.

Adición de reglas (consola)

La página Reglas muestra las reglas y los resultados de conformidad actuales en una tabla. El resultado de cada regla es Evaluando... hasta AWS Config termine de evaluar sus recursos en función de la regla. Puede actualizar los resultados con el botón de actualizar. ¿Cuándo AWS Config finaliza las evaluaciones, puede ver las reglas y los tipos de recursos que cumplen o no las cumplen. Para obtener más información, consulte Visualización de la información de cumplimiento y los resultados de la evaluación de su AWS Recursos con AWS Config.

nota

Cuando agregas una regla nueva, AWS Config evalúa los recursos aplicables en su inventario de recursos, incluidos los recursos registrados anteriormente. Por ejemplo, si ha registrado recursos de AWS::IoT::Policy pero luego los ha excluido del registro, AWS Config conserva los elementos de configuración (CI) iniciales de su inventario. Aunque AWS Config ya no actualiza estos elementos de configuración cuando sus tipos de recursos asociados no se registran, conserva su último estado registrado y los evalúa al añadir las reglas aplicables.

AWS Config no evalúa los recursos que no están en el inventario de recursos. Por ejemplo, si agrega el amplify-branch-tagged regla pero no grabe y nunca haya grabado AWS::Amplify::Branch recursos, AWS Config no puede evaluar si el AWS Amplify las sucursales de tu cuenta cumplen o no las cumplen.

Para obtener más información, consulte Grabación de AWS recursos con AWS Config.

Para añadir una regla
  1. Inicia sesión en Consola de administración de AWS y abre el AWS Config consola en https://console.aws.amazon.com/config/home.

  2. En el Consola de administración de AWS en el menú, compruebe que el selector de regiones esté configurado en una región compatible AWS Config reglas. Para ver una lista de las regiones admitidas, consulte Regiones y puntos de enlace de AWS Config en la Referencia general de Amazon Web Services.

  3. En el panel de navegación izquierdo, seleccione Rules (Reglas).

  4. En la página Rules (Reglas), seleccione Add rule (Añadir regla).

  5. En la página Especificar tipo de regla, especifique el tipo de regla siguiendo estos pasos:

    1. En el campo de búsqueda para filtrar escriba la lista de las reglas administradas por nombre de regla, descripción y etiqueta. Por ejemplo, escriba EC2 para que devuelva las reglas que evalúan tipos de recursos de EC2 o escriba periodic para que devuelva reglas que se activen periódicamente.

    2. También puede crear sus propia regla personalizada. Elige Cree una regla personalizada con Lambda o Crea una regla personalizada con Guardy siga el procedimiento que se indica en Creando AWS Config Reglas Lambda personalizadas o Creando AWS Config Reglas de política personalizadas.

  6. En la página Configurar regla, configure la regla siguiendo estos pasos:

    1. En Name (Nombre), escriba un nombre único para la regla.

    2. En Descripción, escriba una descripción para la regla.

    3. Para Modo de evaluación, elige en qué momento del proceso de creación y administración de recursos deseas AWS Config para evaluar sus recursos. Según la regla, AWS Config puede evaluar las configuraciones de sus recursos antes de que se implemente un recurso, después de que se haya implementado un recurso o ambas cosas.

      1. Elija Active la evaluación proactiva para ejecutar evaluaciones de los valores de configuración de sus recursos antes de que se implementen.

        Una vez que haya activado la evaluación proactiva, puede utilizar el StartResourceEvaluation API y GetResourceEvaluationSummary API para comprobar si los recursos que especificas en estos comandos se marcarían como NON_COMPLIANT según las reglas proactivas de tu cuenta en tu región.

        Para obtener más información sobre el uso de estos comandos, consulta Evaluación de sus recursos con AWS Config Reglas. Para obtener una lista de las reglas administradas que respaldan la evaluación proactiva, consulte Lista de AWS Config Reglas administradas por modo de evaluación.

      2. Seleccione Active la evaluación de detectives para evaluar los ajustes de la configuración de los recursos existentes.

        Para la evaluación de detectives, existen dos tipos de desencadenadores: Cuando cambia la configuración y Periódico.

        1. Si los tipos de activación de su regla incluyen Cambios en la configuración, especifique una de las siguientes opciones para Alcance de los cambios con qué AWS Config invoca tu función Lambda:

          • Recursos: cuando se crea, cambia o elimina un recurso específico que coincide con un tipo de recurso específico o con un tipo más el identificador.

          • Etiquetas: cuando se crea, cambia o elimina un recurso con la etiqueta especificada.

          • Todos los cambios — Cuando un recurso es registrado por AWS Config se crea, cambia o elimina.

          AWS Config ejecuta la evaluación cuando detecta un cambio en un recurso que coincide con el alcance de la regla. Puede utilizar el ámbito para definir los recursos que activan evaluaciones.

        2. Si los tipos de desencadenantes de la regla incluyen Periódico, especifique el Frecuencia con la que AWS Config invoca tu función Lambda.

    4. Si su regla incluye Parámetros, puede personalizar los valores de las claves proporcionadas. Un parámetro es un atributo que deben cumplir los recursos para que se considere que cumplen la regla.

  7. En la página Revisar y crear, revise todas las selecciones antes de añadir la regla a la Cuenta de AWS. Si la regla no funciona según lo previsto, puede que vea una de las siguientes opciones para Conformidad:

    • No se informó de ningún resultado - AWS Config evaluó sus recursos de acuerdo con la regla. La regla no se aplicaba a AWS los recursos incluidos en su ámbito, se eliminaron los recursos especificados o se eliminaron los resultados de la evaluación. Para obtener los resultados de la evaluación, actualice la regla, cambie su alcance o elija Re-evaluate.

      Este mensaje también puede aparecer si la regla no informa de resultados de evaluación.

    • No hay recursos disponibles - AWS Config no puede evaluar su grabación AWS recursos en contra de esta regla porque ninguno de sus recursos está dentro del alcance de la regla. Para obtener los resultados de la evaluación, edite la regla y cambie su alcance, o añada recursos para AWS Config para grabar mediante el Ajustes página.

    • Evaluations failed (Error en las evaluaciones): para obtener información que le ayude a determinar el problema, elija el nombre de la regla para abrir la página de detalles y ver el mensaje de error.

Agregar reglas (AWS (SDK)

Los siguientes ejemplos de código muestran cómo utilizar PutConfigRule.

CLI
AWS CLI

Ejemplo 1: Para agregar un AWS regla de configuración administrada

Lo siguiente put-config-rule El ejemplo proporciona código JSON para agregar un AWS regla de configuración gestionada.

aws configservice put-config-rule \ --config-rule file://RequiredTagsForEC2Instances.json

RequiredTagsForEC2Instances.json es un archivo JSON que contiene la configuración de la regla.

Contenido de RequiredTagsForEC2Instances.json:

{ "ConfigRuleName": "RequiredTagsForEC2Instances", "Description": "Checks whether the CostCenter and Owner tags are applied to EC2 instances.", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "Source": { "Owner": "AWS", "SourceIdentifier": "REQUIRED_TAGS" }, "InputParameters": "{\"tag1Key\":\"CostCenter\",\"tag2Key\":\"Owner\"}" }

Para el ComplianceResourceTypes atributo, este código JSON limita el alcance a los recursos del AWS::EC2::Instance escriba, por lo que AWS La configuración evaluará solo las instancias EC2 según la regla. Puesto que la regla es una regla administrada, el atributo Owner se establece en AWS y el atributo SourceIdentifier en el identificador de la regla, REQUIRED_TAGS. Para el atributo InputParameters, se especifican las claves de etiqueta que requiere la regla, CostCenter y Owner.

Este comando no genera ninguna salida. Para verificar la configuración de la regla, ejecute describe-config-rules comando y especifique el nombre de la regla.

Para obtener más información, consulte AWS Configure las reglas administradas en el AWS Guía para desarrolladores de Config.

Ejemplo 2: Para agregar una regla de configuración gestionada por el cliente

Lo siguiente put-config-rule El ejemplo proporciona un código JSON para agregar una regla de configuración gestionada por el cliente.

aws configservice put-config-rule \ --config-rule file://InstanceTypesAreT2micro.json

InstanceTypesAreT2micro.json es un archivo JSON que contiene la configuración de la regla.

Contenido de InstanceTypesAreT2micro.json:

{ "ConfigRuleName": "InstanceTypesAreT2micro", "Description": "Evaluates whether EC2 instances are the t2.micro type.", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "Source": { "Owner": "CUSTOM_LAMBDA", "SourceIdentifier": "arn:aws:lambda:us-west-2:123456789012:function:InstanceTypeCheck", "SourceDetails": [ { "EventSource": "aws.config", "MessageType": "ConfigurationItemChangeNotification" } ] }, "InputParameters": "{\"desiredInstanceType\":\"t2.micro\"}" }

Para el ComplianceResourceTypes atributo, este código JSON limita el alcance a los recursos del AWS::EC2::Instance escriba, por lo que AWS La configuración evaluará solo las instancias EC2 según la regla. Como esta regla es una regla administrada por el cliente, el Owner el atributo está establecido en CUSTOM_LAMBDA, y el SourceIdentifier el atributo se establece en el ARN del AWS función lambda. El objeto SourceDetails es obligatorio. Los parámetros que se especifican para la InputParameters el atributo se pasa al AWS función Lambda cuando AWS La configuración la invoca para evaluar los recursos según la regla.

Este comando no genera ninguna salida. Para verificar la configuración de la regla, ejecute describe-config-rules comando y especifique el nombre de la regla.

Para obtener más información, consulte AWS Configure las reglas personalizadas en el AWS Guía para desarrolladores de Config.

  • Para obtener más información sobre la API, consulte PutConfigRule en AWS CLI Referencia de comandos.

Python
SDK para Python (Boto3)
nota

Hay más sobre GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

class ConfigWrapper: """ Encapsulates AWS Config functions. """ def __init__(self, config_client): """ :param config_client: A Boto3 AWS Config client. """ self.config_client = config_client def put_config_rule(self, rule_name): """ Sets a configuration rule that prohibits making Amazon S3 buckets publicly readable. :param rule_name: The name to give the rule. """ try: self.config_client.put_config_rule( ConfigRule={ "ConfigRuleName": rule_name, "Description": "S3 Public Read Prohibited Bucket Rule", "Scope": { "ComplianceResourceTypes": [ "AWS::S3::Bucket", ], }, "Source": { "Owner": "AWS", "SourceIdentifier": "S3_BUCKET_PUBLIC_READ_PROHIBITED", }, "InputParameters": "{}", "ConfigRuleState": "ACTIVE", } ) logger.info("Created configuration rule %s.", rule_name) except ClientError: logger.exception("Couldn't create configuration rule %s.", rule_name) raise
  • Para obtener más información sobre la API, consulte PutConfigRule en AWS Referencia de la API del SDK para Python (Boto3).

SAP ABAP
SDK para SAP ABAP
nota

Hay más sobre GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

" Create a config rule for S3 bucket public read prohibition lo_cfs->putconfigrule( io_configrule = NEW /aws1/cl_cfsconfigrule( iv_configrulename = iv_rule_name iv_description = |S3 Public Read Prohibited Bucket Rule| io_scope = NEW /aws1/cl_cfsscope( it_complianceresourcetypes = VALUE /aws1/cl_cfscplncresrctypes_w=>tt_complianceresourcetypes( ( NEW /aws1/cl_cfscplncresrctypes_w( |AWS::S3::Bucket| ) ) ) ) io_source = NEW /aws1/cl_cfssource( iv_owner = |AWS| iv_sourceidentifier = |S3_BUCKET_PUBLIC_READ_PROHIBITED| ) iv_inputparameters = '{}' iv_configrulestate = |ACTIVE| ) ). MESSAGE 'Created AWS Config rule.' TYPE 'I'.
  • Para obtener más información sobre la API, consulte PutConfigRule en AWS Referencia sobre el SDK para la API ABAP de SAP.