Soppressioni della ricerca di audit - AWS IoT Device Defender
Come funzionano le soppressioni dei risultati di auditCome utilizzare le soppressioni della ricerca di audit nella consoleCome utilizzare le soppressioni della ricerca di audit nell'interfaccia della riga di comandoRicerca di audit delle soppressioni delle API

Soppressioni della ricerca di audit

Quando si esegue un audit, vengono riportati i risultati per tutte le risorse non conformi. Ciò significa che i rapporti di audit includono risultati per le risorse a cui stai lavorando per mitigare i problemi e anche per le risorse che sono notoriamente non conformi, ad esempio dispositivi di test o danneggiati. Il controllo continua a segnalare i risultati per le risorse che rimangono non conformi nelle successive esecuzioni di audit e che potrebbero aggiungere informazioni indesiderate ai report. Le soppressioni di ricerca di audit consentono di sopprimere o filtrare i risultati per un periodo di tempo definito fino a quando la risorsa non viene sistemata oppure fino a tempo indeterminato per una risorsa associata a un dispositivo di prova o danneggiato.

Nota

Le operazioni di attenuazione non saranno disponibili per i risultati di audit soppressi. Per ulteriori informazioni sulle operazioni di mitigazione, consulta Operazioni di mitigazione.

Per informazioni sull'audit per individuare le quote di soppressione, consulta Endpoint e quote di AWS IoT Device Defender.

Come funzionano le soppressioni dei risultati di audit

Quando si crea una soppressione della ricerca di audit per una risorsa non conforme, i rapporti di audit e le notifiche si comportano in modo diverso.

I rapporti di audit includeranno una nuova sezione che elenca tutti i risultati eliminati associati al report. I risultati eliminati non verranno presi in considerazione quando valutiamo se un controllo di audit è conforme o meno. Viene inoltre restituito un conteggio delle risorse soppresse per ogni controllo di audit quando si utilizza il comando describe-audit-task nell'interfaccia a riga di comando (CLI).

Per le notifiche di audit, i risultati eliminati non vengono presi in considerazione quando si valuta se un controllo di audit è conforme o meno. Un conteggio delle risorse soppresse è incluso in ogni notifica di controllo audit che AWS IoT Device Defender pubblica su Amazon CloudWatch e Amazon Simple Notification Service (Amazon SNS).

Come utilizzare le soppressioni della ricerca di audit nella console

Per sopprimere un risultato da un rapporto di audit

La procedura seguente mostra come creare una soppressione della ricerca di audit nell’AWS IoT console.

  1. Nell’AWS IoT console, nel riquadro di navigazione, espandi Defend (Protezione) e scegli Audit (Audit), quindi Results (Risultati).

  2. Seleziona un rapporto di audit che desideri esaminare.

    Tabella dei risultati degli audit AWS IoT Device Defender che mostra lo stato di conformità per più audit effettuati di recente, con la maggior parte degli audit contrassegnati come non conformi.

  3. Nella sezione Non-compliant checks (Controlli non conformi), in Check name (Controlla il nome) scegli il controllo di audit che ti interessa.

    Report di audit che mostra un controllo di non conformità del logging disabilitato e 13 controlli di conformità tra i livelli di gravità (critico, alto e medio) per un servizio AWS.

  4. Nella schermata dei dettagli del controllo di audit, se ci sono risultati che non desideri visualizzare, seleziona il pulsante di opzione accanto al risultato. Quindi, seleziona Actions (Operazioni) e scegli il periodo di tempo in cui desideri che la soppressione del rilevamento di audit venga mantenuta.

    Nota

    Nella console, puoi selezionare 1 week (1 settimana), 1 month (1 mese), 3 months (3 mesi), 6 months (6 mesi) oppure Indefinitely (A tempo indeterminato) come date di scadenza per l'eliminazione dei risultati di verifica. Se desideri impostare una data di scadenza specifica, puoi farlo solo nell'interfaccia della riga di comando o nell'API. Le soppressioni della ricerca di audit possono anche essere annullate in qualsiasi momento, indipendentemente dalla data di scadenza.

    Esiti dell'audit AWS IoT Device Defender che mostrano che il logging è disattivato e 1 account non conforme con dettagli e misure di mitigazione.

  5. Conferma i dettagli di soppressione e scegli Enable suppression (Abilita la soppressione).

    Finestra di dialogo Conferma soppressione con il nome del controllo Logging disabilitato, il numero di impostazioni dell'account, il periodo di scadenza di 3 mesi e la data di scadenza del 28/10/2020.

  6. Dopo aver creato la soppressione della ricerca di audit, viene visualizzato un banner che lo conferma.

    Pagina dei risultati dell'audit AWS IoT Device Defender che mostra un account non conforme con logging disattivato e una fase di mitigazione per abilitare CloudWatch Logs.
Per visualizzare i risultati soppressi in un report di audit

  1. Nell’AWS IoT console, nel riquadro di navigazione, espandi Defend (Protezione) e scegli Audit (Audit), quindi Results (Risultati).

  2. Seleziona un rapporto di audit che desideri esaminare.

  3. Nella sezione Suppressed findings (Risultati eliminati), visualizza quali risultati di audit sono stati eliminati per il report di audit scelto.

    Report di audit AWS IoT Device Defender che mostra i controlli di conformità con livelli di gravità e riepilogo degli esiti.
Per elencare le soppressioni della ricerca di audit

  • Nell’AWS IoT console, nel riquadro di navigazione, espandi Defend (Protezione) e scegli Audit (Audit), Finding suppressions (Ricerca di eliminazione).

    Tabella delle soppressioni degli esiti di audit AWS IoT Device Defender con un'unica soppressione per il controllo "Logging disattivato" con scadenza il 28 ottobre 2020.
Per modificare la soppressione della ricerca di audit

  1. Nell’AWS IoT console, nel riquadro di navigazione, espandi Defend (Protezione) e scegli Audit (Audit), Finding suppressions (Ricerca di eliminazione).

  2. Seleziona il pulsante di opzione accanto al tipo di soppressione dei risultati di audit che desideri modificare. Quindi, seleziona Actions (Operazioni), Edit (Modifica).

  3. Sulla finestra Edit audit finding suppression (Modifica la soppressione della ricerca di audit) è possibile modificare Suppression duration (Durata della eliminazione) o Description (Descrizione) (facoltativa).

    Finestra di dialogo Modifica la soppressione degli audit con le opzioni per eliminare il controllo "Logging disabilitato" relativo alla risorsa specificata per 6 mesi e il campo di descrizione.

  4. Dopo avere effettuato le modifiche, scegli Save (Salva). Si apre la finestra Finding suppressions (Ricerca di soppressioni).

Per eliminare una soppressione della ricerca di audit

  1. Nell’AWS IoT console, nel riquadro di navigazione, espandi Defend (Protezione) e scegli Audit (Audit), Finding suppressions (Ricerca di eliminazione).

  2. Seleziona il pulsante di opzione accanto alla soppressione della ricerca di audit da eliminare e quindi scegli Actions (Operazioni), Delete (Elimina).

  3. Sulla finestra Delete audit finding suppression (Elimina la soppressione della ricerca di audit), immetti delete nella casella di testo per confermare l'eliminazione, quindi seleziona Delete (Elimina). Si apre la finestra Finding suppressions (Ricerca di soppressioni).

    Finestra di dialogo per l'eliminazione della soppressione degli esiti di audit, con il campo di immissione per inserire "elimina" e il pulsante Elimina.

Come utilizzare le soppressioni della ricerca di audit nell'interfaccia della riga di comando

È possibile utilizzare i seguenti comandi CLI per creare e gestire le soppressioni dei risultati di audit.

Il resource-identifier che immetti dipende dal check-name per cui stai sopprimendo i risultati. Nella tabella seguente sono riportati i dettagli che richiedono i controlli, quali i resource-identifier per la creazione e la modifica delle soppressioni.

Nota

I comandi di soppressione non indicano la disattivazione di un audit. Gli audit continueranno a essere eseguiti sui tuoi dispositivi AWS IoT. Le soppressioni sono applicabili solo ai risultati dell'audit.

check-name resource-identifier
AUTHENTICATE_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK cognitoIdentityPoolId
CA_CERT_APPROACHING_EXPIRATION_CHECK caCertificateId
CA_CERTIFICATE_KEY_QUALITY_CHECK caCertificateId
CONFLICTING_CLIENT_IDS_CHECK clientId
DEVICE_CERT_APPROACHING_EXPIRATION_CHECK deviceCertificateId
DEVICE_CERTIFICATE_KEY_QUALITY_CHECK deviceCertificateId
DEVICE_CERTIFICATE_SHARED_CHECK deviceCertificateId
IOT_POLICY_OVERLY_PERMISSIVE_CHECK policyVersionIdentifier
IOT_ROLE_ALIAS_ALLOWS_ACCESS_TO_UNUSED_SERVICES_CHECK roleAliasArn
IOT_ROLE_ALIAS_OVERLY_PERMISSIVE_CHECK roleAliasArn
LOGGING_DISABLED_CHECK account
REVOKED_CA_CERT_CHECK caCertificateId
REVOKED_DEVICE_CERT_CHECK deviceCertificateId
UNAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK cognitoIdentityPoolId
Per creare e applicare una soppressione di ricerca di audit

La procedura seguente mostra come creare una soppressione della ricerca di audit nella CLI dei servizi AWS.

  • Utilizza il comando create-audit-suppression per creare una soppressione della ricerca di audit. Nell'esempio seguente viene creata una soppressione della ricerca di audit per l’account Account AWS 123456789012 sulla base del controllo Registrazione disattivata.

    aws iot create-audit-suppression \
    --check-name LOGGING_DISABLED_CHECK \
    --resource-identifier account=123456789012 \
    --client-request-token 28ac32c3-384c-487a-a368-c7bbd481f554 \
    --suppress-indefinitely \
    --description "Suppresses logging disabled check because I don't want to enable logging for now."

    Non esiste un output per questo comando.

Ricerca di audit delle soppressioni delle API

Le seguenti API possono essere utilizzate per creare e gestire le soppressioni della ricerca di audit.

Per filtrare per risultati specifici di audit, è possibile utilizzare l’API ListAuditFindings.