aws-cdk-lib.aws_iot.CfnAccountAuditConfiguration.AuditCheckConfigurationsProperty

interface AuditCheckConfigurationsProperty

LanguageType name
.NETAmazon.CDK.AWS.IoT.CfnAccountAuditConfiguration.AuditCheckConfigurationsProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsiot#CfnAccountAuditConfiguration_AuditCheckConfigurationsProperty
Javasoftware.amazon.awscdk.services.iot.CfnAccountAuditConfiguration.AuditCheckConfigurationsProperty
Pythonaws_cdk.aws_iot.CfnAccountAuditConfiguration.AuditCheckConfigurationsProperty
TypeScript aws-cdk-lib » aws_iot » CfnAccountAuditConfiguration » AuditCheckConfigurationsProperty

The types of audit checks that can be performed.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_iot as iot } from 'aws-cdk-lib';
const auditCheckConfigurationsProperty: iot.CfnAccountAuditConfiguration.AuditCheckConfigurationsProperty = {
  authenticatedCognitoRoleOverlyPermissiveCheck: {
    enabled: false,
  },
  caCertificateExpiringCheck: {
    enabled: false,
  },
  caCertificateKeyQualityCheck: {
    enabled: false,
  },
  conflictingClientIdsCheck: {
    enabled: false,
  },
  deviceCertificateExpiringCheck: {
    enabled: false,
  },
  deviceCertificateKeyQualityCheck: {
    enabled: false,
  },
  deviceCertificateSharedCheck: {
    enabled: false,
  },
  intermediateCaRevokedForActiveDeviceCertificatesCheck: {
    enabled: false,
  },
  iotPolicyOverlyPermissiveCheck: {
    enabled: false,
  },
  ioTPolicyPotentialMisConfigurationCheck: {
    enabled: false,
  },
  iotRoleAliasAllowsAccessToUnusedServicesCheck: {
    enabled: false,
  },
  iotRoleAliasOverlyPermissiveCheck: {
    enabled: false,
  },
  loggingDisabledCheck: {
    enabled: false,
  },
  revokedCaCertificateStillActiveCheck: {
    enabled: false,
  },
  revokedDeviceCertificateStillActiveCheck: {
    enabled: false,
  },
  unauthenticatedCognitoRoleOverlyPermissiveCheck: {
    enabled: false,
  },
};

Properties

NameTypeDescription
authenticatedCognitoRoleOverlyPermissiveCheck?IResolvable | AuditCheckConfigurationPropertyChecks the permissiveness of an authenticated Amazon Cognito identity pool role.
caCertificateExpiringCheck?IResolvable | AuditCheckConfigurationPropertyChecks if a CA certificate is expiring.
caCertificateKeyQualityCheck?IResolvable | AuditCheckConfigurationPropertyChecks the quality of the CA certificate key.
conflictingClientIdsCheck?IResolvable | AuditCheckConfigurationPropertyChecks if multiple devices connect using the same client ID.
deviceCertificateExpiringCheck?IResolvable | AuditCheckConfigurationPropertyChecks if a device certificate is expiring.
deviceCertificateKeyQualityCheck?IResolvable | AuditCheckConfigurationPropertyChecks the quality of the device certificate key.
deviceCertificateSharedCheck?IResolvable | AuditCheckConfigurationPropertyChecks if multiple concurrent connections use the same X.509 certificate to authenticate with AWS IoT .
intermediateCaRevokedForActiveDeviceCertificatesCheck?IResolvable | AuditCheckConfigurationPropertyCfnAccountAuditConfiguration.AuditCheckConfigurationsProperty.IntermediateCaRevokedForActiveDeviceCertificatesCheck.
ioTPolicyPotentialMisConfigurationCheck?IResolvable | AuditCheckConfigurationPropertyCfnAccountAuditConfiguration.AuditCheckConfigurationsProperty.IoTPolicyPotentialMisConfigurationCheck.
iotPolicyOverlyPermissiveCheck?IResolvable | AuditCheckConfigurationPropertyChecks the permissiveness of a policy attached to an authenticated Amazon Cognito identity pool role.
iotRoleAliasAllowsAccessToUnusedServicesCheck?IResolvable | AuditCheckConfigurationPropertyChecks if a role alias has access to services that haven't been used for the AWS IoT device in the last year.
iotRoleAliasOverlyPermissiveCheck?IResolvable | AuditCheckConfigurationPropertyChecks if the temporary credentials provided by AWS IoT role aliases are overly permissive.
loggingDisabledCheck?IResolvable | AuditCheckConfigurationPropertyChecks if AWS IoT logs are disabled.
revokedCaCertificateStillActiveCheck?IResolvable | AuditCheckConfigurationPropertyChecks if a revoked CA certificate is still active.
revokedDeviceCertificateStillActiveCheck?IResolvable | AuditCheckConfigurationPropertyChecks if a revoked device certificate is still active.
unauthenticatedCognitoRoleOverlyPermissiveCheck?IResolvable | AuditCheckConfigurationPropertyChecks if policy attached to an unauthenticated Amazon Cognito identity pool role is too permissive.

authenticatedCognitoRoleOverlyPermissiveCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks the permissiveness of an authenticated Amazon Cognito identity pool role.

For this check, AWS IoT Device Defender audits all Amazon Cognito identity pools that have been used to connect to the AWS IoT message broker during the 31 days before the audit is performed.


caCertificateExpiringCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if a CA certificate is expiring.

This check applies to CA certificates expiring within 30 days or that have expired.


caCertificateKeyQualityCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks the quality of the CA certificate key.

The quality checks if the key is in a valid format, not expired, and if the key meets a minimum required size. This check applies to CA certificates that are ACTIVE or PENDING_TRANSFER .


conflictingClientIdsCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if multiple devices connect using the same client ID.


deviceCertificateExpiringCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if a device certificate is expiring.

This check applies to device certificates expiring within 30 days or that have expired.


deviceCertificateKeyQualityCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks the quality of the device certificate key.

The quality checks if the key is in a valid format, not expired, signed by a registered certificate authority, and if the key meets a minimum required size.


deviceCertificateSharedCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if multiple concurrent connections use the same X.509 certificate to authenticate with AWS IoT .


intermediateCaRevokedForActiveDeviceCertificatesCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

CfnAccountAuditConfiguration.AuditCheckConfigurationsProperty.IntermediateCaRevokedForActiveDeviceCertificatesCheck.


ioTPolicyPotentialMisConfigurationCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

CfnAccountAuditConfiguration.AuditCheckConfigurationsProperty.IoTPolicyPotentialMisConfigurationCheck.


iotPolicyOverlyPermissiveCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks the permissiveness of a policy attached to an authenticated Amazon Cognito identity pool role.


iotRoleAliasAllowsAccessToUnusedServicesCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if a role alias has access to services that haven't been used for the AWS IoT device in the last year.


iotRoleAliasOverlyPermissiveCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if the temporary credentials provided by AWS IoT role aliases are overly permissive.


loggingDisabledCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if AWS IoT logs are disabled.


revokedCaCertificateStillActiveCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if a revoked CA certificate is still active.


revokedDeviceCertificateStillActiveCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if a revoked device certificate is still active.


unauthenticatedCognitoRoleOverlyPermissiveCheck?

Type: IResolvable | AuditCheckConfigurationProperty (optional)

Checks if policy attached to an unauthenticated Amazon Cognito identity pool role is too permissive.