Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Prerequisiti per la configurazione AWS Config con AWS CLI
Prima di eseguire la configurazione AWS con AWS CLI, è necessario creare un bucket Amazon S3, un SNS argomento Amazon e un IAM ruolo con policy allegate come prerequisiti. Puoi quindi utilizzare il AWS CLI per specificare il bucket, l'argomento e il ruolo per. AWS Config Segui questa procedura per configurare i prerequisiti per AWS Config.
Argomenti
Fase 1: creazione di un bucket Amazon S3
Se disponi già di un bucket Amazon S3 nell'account e desideri utilizzarlo, puoi ignorare questo passaggio e passare direttamente a Passaggio 2: creazione di un SNS argomento Amazon.
Per creare un bucket
Apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/
-
Seleziona Crea bucket.
-
In Bucket name, inserisci un nome DNS conforme a -per il tuo bucket.
Il nome del bucket deve:
-
Essere univoco in tutto Amazon S3.
-
Deve contenere da 3 a 63 caratteri
-
Non contiene caratteri maiuscoli.
-
Iniziare con una lettera minuscola o un numero.
Una volta creato il bucket, non è possibile modificarne il nome. Assicurati che il nome assegnato al bucket sia univoco tra tutti i nomi di bucket esistenti in Amazon S3. Per ulteriori informazioni sulle regole e le convenzioni di denominazione dei bucket, consulta Restrizioni e limitazioni dei bucket nella Guida per l'utente di Amazon Simple Storage Service.
Importante
Evita di includere informazioni sensibili nel nome del bucket. Il nome del bucket è visibile in URLs quel punto agli oggetti nel bucket.
-
-
In Regione, scegli la AWS regione in cui desideri che risieda il bucket.
Scegliere una regione nelle vicinanze per ridurre al minimo la latenza e i costi o rispondere a requisiti normativi. Gli oggetti archiviati in una regione non la lasciano mai a meno che non vengano trasferiti esplicitamente in un'altra regione. Per un elenco delle AWS regioni Amazon S3, consulta gli endpoint AWS di servizio nel. Riferimenti generali di Amazon Web Services
-
In Bucket settings for Block Public Access (Impostazioni bucket per blocco dell'accesso pubblico), scegliere le impostazioni del blocco dell'accesso pubblico che si desidera applicare al bucket.
Si consiglia di lasciare tutte le impostazioni abilitate, a meno che non si sappia che è necessario disattivarne una o più per il caso d'uso, ad esempio per ospitare un sito Web pubblico. Le impostazioni di blocco dell'accesso pubblico abilitate per il bucket saranno abilitate anche per tutti i punti di accesso creati nel bucket. Per ulteriori informazioni sul blocco dell'accesso pubblico, consulta Blocco dell’accesso pubblico di Amazon S3 nella Guida per l'utente di Amazon Simple Storage Service.
-
(Facoltativo) Se si desidera abilitare il Blocco degli oggetti S3:
-
Scegliere Advanced settings (Impostazioni avanzate) e leggere il messaggio visualizzato.
Importante
È possibile abilitare il blocco oggetti S3 per un bucket solo quando lo si crea. Se si abilita il blocco oggetti per il bucket, non è possibile disabilitarlo in un secondo momento. L'abilitazione del blocco oggetti consente anche la funzione Versioni multiple del bucket. Dopo aver abilitato il blocco oggetti per il bucket, è necessario configurare le impostazioni di blocco oggetti prima che tutti gli oggetti nel bucket vengano protetti. Per ulteriori informazioni sulla configurazione della protezione per gli oggetti, consulta Configurazione di Object Lock S3 utilizzando la console Amazon S3.
-
Se si desidera abilitare il blocco oggetti, immettere abilita nella casella di testo e scegliere Confirm (Conferma).
Per ulteriori informazioni sulla funzionalità Object Lock S3, consulta Utilizzo di Object Lock S3 nella Guida per l'utente di Amazon Simple Storage Service.
-
-
Seleziona Crea bucket.
Quando si utilizza il AWS SDKs per creare un bucket, è necessario creare un client e quindi utilizzare il client per inviare una richiesta di creazione di un bucket. Come best practice, crea il client e il bucket nella stessa Regione AWS. Se non specifichi una regione quando crei un client o un bucket, Amazon S3 utilizza la regione predefinita Stati Uniti orientali (Virginia settentrionale).
Per creare un client per accedere a un endpoint dual-stack, devi specificare un. Regione AWS Per ulteriori informazioni, consulta Endpoint dual-stack Amazon S3. Per un elenco di quelli disponibili Regioni AWS, consulta Regioni ed endpoint in. Riferimenti generali di AWS
Quando si crea un client, la regione viene mappata all'endpoint specifico della regione. Il client utilizza questo endpoint per comunicare con Amazon S3: s3.
. Se la tua regione è stata lanciata dopo il 20 marzo 2019, il tuo client e il tuo bucket devono trovarsi nella stessa regione. Puoi comunque utilizzare un client nella regione Stati Uniti orientali (Virginia settentrionale) per creare un bucket in qualsiasi regione lanciata prima del 20 marzo 2019. Per ulteriori informazioni, consulta Endpoint legacy.<region>
.amazonaws.com
Questi esempi di AWS SDK codice eseguono le seguenti attività:
-
Creazione di un client specificando esplicitamente una Regione AWS - Nell'esempio, il client utilizza l'endpoint
s3.us-west-2.amazonaws.com
per comunicare con Amazon S3. Puoi specificare qualsiasi Regione AWS. Per un elenco di Regioni AWS, consulta Regioni ed endpoint nel Riferimento AWS generale. -
Inviare una richiesta di creazione di bucket specificando solo il nome del bucket - Il client invia ad Amazon S3 la richiesta di creare il bucket nella regione in cui hai creato un client.
-
Recupero delle informazioni sulla posizione del bucket - Amazon S3 memorizza le informazioni sulla posizione del bucket nella risorsa secondaria posizione associata al bucket.
I seguenti esempi di codice mostrano come utilizzareCreateBucket
.
Nota
Puoi anche utilizzare un bucket Amazon S3 di un altro account, ma in questo caso potrebbe essere necessario creare una policy che conceda al bucket le autorizzazioni di accesso a AWS Config. Per informazioni sulla concessione di autorizzazioni a un bucket Amazon S3, consulta Autorizzazioni per il bucket Amazon S3 per il canale di distribuzione AWS Config e vai quindi a Passaggio 2: creazione di un SNS argomento Amazon.
Passaggio 2: creazione di un SNS argomento Amazon
Se hai già un SNS argomento Amazon nel tuo account e desideri utilizzarlo, salta questo passaggio e vai aFase 3: Creazione di un ruolo IAM.
Per creare un SNS argomento Amazon
Apri la SNS console Amazon su https://console.aws.amazon.com/sns/v3/home
. -
Esegui una di queste operazioni:
-
Se non è mai stato creato alcun argomento sotto il tuo Account AWS profilo in precedenza, leggi la descrizione di SNS Amazon nella home page.
-
Se in Account AWS precedenza sono stati creati argomenti sotto il tuo nome, nel pannello di navigazione, scegli Argomenti.
-
-
Nella pagina Topics (Argomenti), seleziona Create new topic (Crea nuovo argomento).
-
Nella pagina Create topic (Crea argomento), nella sezione Details (Dettagli), eseguire queste operazioni:
-
Per Tipo, scegli un tipo di argomento (Standard o FIFO).
-
Immetti un nome per l'argomento. Per un FIFOargomento, aggiungete .fifo alla fine del nome.
-
(Facoltativo) Compilare il Display name (Nome visualizzato) per l'argomento.
-
(Facoltativo) Per un FIFO argomento, puoi scegliere la deduplicazione dei messaggi basata sul contenuto per abilitare la deduplicazione predefinita dei messaggi. Per ulteriori informazioni, consulta Deduplicazione dei messaggi per gli argomenti. FIFO
-
-
(Facoltativo) Espandere la sezione Encryption (Crittografia) e procedere come segue. Per ulteriori informazioni, consultare Crittografia dei dati inattivi.
-
Scegliere Enable encryption (Abilita crittografia).
-
Specificare la chiave principale del cliente ()CMK. Per ulteriori informazioni, consulta Termini chiave.
Per ogni CMK tipo, CMKARNvengono visualizzati la Descrizione, l'Account e.
Importante
Se non sei il proprietario diCMK, o se accedi con un account che non dispone delle
kms:DescribeKey
autorizzazionikms:ListAliases
e, non potrai visualizzare le informazioni in merito CMK sulla SNS console Amazon.Chiedi al proprietario di CMK concederti queste autorizzazioni. Per ulteriori informazioni, consulta la sezione AWS KMS APIAutorizzazioni: azioni e risorse di riferimento nella Guida per gli AWS Key Management Service sviluppatori.
-
L'alias/aws/sns AWS gestito CMK per Amazon SNS (predefinito) è selezionato per impostazione predefinita.
Nota
Ricorda quanto segue:
-
La prima volta che usi AWS Management Console per specificare AWS managed CMK for Amazon SNS per un argomento, AWS KMS crea AWS managed CMK for AmazonSNS.
-
In alternativa, la prima volta che utilizzi l'
Publish
azione su un argomento con SSE abilitato, AWS KMS crea il AWS managed CMK for AmazonSNS.
-
-
Per utilizzare una tua chiave personalizzata CMK Account AWS, scegli il campo Customer master key (CMK), quindi scegli la personalizzata CMK dall'elenco.
Nota
Per istruzioni sulla creazione di chiavi personalizzateCMKs, consulta Creating Keys nella AWS Key Management Service Developer Guide
-
Per utilizzare una chiave personalizzata CMK ARN del tuo Account AWS o di un altro AWS account, inseriscila nel campo Customer master key (CMK).
-
-
-
(Facoltativo) Per impostazione predefinita, solo il proprietario dell'argomento può pubblicare o sottoscrivere l'argomento. Per configurare autorizzazioni di accesso aggiuntive, espandi la sezione Access policy (Policy di accesso) . Per ulteriori informazioni, consulta Gestione delle identità e degli accessi in Amazon SNS e Casi di esempio per il controllo degli SNS accessi di Amazon.
Nota
Quando crei un argomento utilizzando la console, la policy predefinita utilizza la chiave di condizione
aws:SourceOwner
. Questa chiave è analoga aaws:SourceAccount
. -
(Facoltativo) Per configurare in che modo Amazon SNS ritenta i tentativi di recapito dei messaggi non riusciti, espandi la sezione Delivery retry policy (HTTP/S). Per ulteriori informazioni, consulta la sezione Tentativi di recapito dei SNS messaggi di Amazon.
-
(Facoltativo) Per configurare il modo in cui Amazon SNS registra la consegna dei messaggi CloudWatch, espandi la sezione Registrazione dello stato di consegna. Per ulteriori informazioni, consulta lo stato di consegna dei SNS messaggi di Amazon.
-
(facoltativo) Per aggiungere tag di metadati all'argomento, espandere la sezione Tags (Tag), immettere una Key (Chiave) e un Value (Valore) (opzionale) e scegliere Add tag (Aggiungi tag). Per ulteriori informazioni, consulta Amazon SNS topic tagging.
-
Scegli Create topic (Crea argomento).
L'argomento viene creato e il
MyTopic
viene visualizzata la pagina.Il nome dell'argomento ARN, (opzionale) il nome visualizzato e l'ID dell' AWS account del proprietario dell'argomento vengono visualizzati nella sezione Dettagli.
-
Copia l'argomento negli appunti, ARN ad esempio:
arn:aws:sns:us-east-2:123456789012:MyTopic
Per iscrivere un indirizzo e-mail all'SNSargomento Amazon
Apri la SNS console Amazon su https://console.aws.amazon.com/sns/v3/home
. -
Nel pannello di navigazione sinistro scegli Sottoscrizioni.
-
Nella pagina Sottoscrizioni scegli Crea sottoscrizione.
-
Nella pagina Crea sottoscrizione, nella sezione Dettagli, eseguire queste operazioni:
-
Per Argomento ARN, scegli l'Amazon Resource Name (ARN) di un argomento.
-
Per Protocollo, scegli un tipo di endpoint. I tipi di endpoint disponibili sono:
-
Nota
Per iscriverti a un SNSFIFOargomento, scegli questa opzione.
-
Per Endpoint, inserisci il valore dell'endpoint, ad esempio un indirizzo e-mail o il numero ARN di una coda AmazonSQS.
-
Solo endpoint Firehose: per il ruolo Subscription ARN, specifica il IAM ruolo che hai creato per la scrittura nei flussi ARN di distribuzione Firehose. Per ulteriori informazioni, consulta gli argomenti Prerequisiti per la sottoscrizione dei flussi di distribuzione di Firehose ad Amazon. SNS
-
(Facoltativo) Per gli endpoint FirehoseSQS, Amazon, HTTP /S, puoi anche abilitare il recapito di messaggi non elaborati. Per ulteriori informazioni, consulta Amazon SNS Raw Message Delivery.
-
(Facoltativo) Per configurare un criterio di filtro, espandere la sezione policy di filtro della sottoscrizione. Per ulteriori informazioni, consulta le politiche di filtro degli SNS abbonamenti di Amazon.
-
(Facoltativo) Per configurare una coda DLQ per la sottoscrizione, espandere la sezione Policy di redrive (coda DLQ). Per ulteriori informazioni, consulta Amazon SNS dead-letter queues (). DLQs
-
Scegli Create Subscription (Crea sottoscrizione).
La console crea la sottoscrizione e apre la pagina dettagli della sottoscrizione.
-
Per utilizzare un AWS SDK, è necessario configurarlo con le proprie credenziali. Per ulteriori informazioni, consulta I file di configurazione e credenziali condivisi nella AWS SDKs and Tools Reference Guide.
I seguenti esempi di codice mostrano come utilizzare. CreateTopic
Nota
Puoi anche utilizzare un SNS argomento Amazon in un altro account, ma in tal caso potresti dover creare una politica per argomento a cui concedere le autorizzazioni di accesso. AWS Config Per informazioni sulla concessione delle autorizzazioni a un SNS argomento di Amazon, consulta Autorizzazioni per l'argomento Amazon SNS e poi vai a. Fase 3: Creazione di un ruolo IAM
Fase 3: Creazione di un ruolo IAM
Puoi utilizzare la IAM console per creare un IAM ruolo che conceda AWS Config le autorizzazioni per accedere al tuo bucket Amazon S3, accedere al tuo argomento SNS Amazon e ottenere dettagli di configurazione per le risorse supportate. AWS Quando usi la console per creare un IAM ruolo, assegna AWS Config automaticamente le autorizzazioni necessarie al ruolo.
Nota
Se hai utilizzato un AWS servizio che utilizza AWS Config (come AWS Security Hub o AWS Control Tower) e un AWS Config ruolo è già stato creato, assicurati che il IAM ruolo che usi durante la configurazione AWS Config mantenga gli stessi privilegi minimi del AWS Config ruolo già creato in modo che l'altro AWS servizio continui a funzionare come previsto.
Ad esempio, se AWS Control Tower ha un IAM ruolo che AWS Config consente di leggere oggetti Amazon S3, è necessario garantire che vengano concesse le stesse autorizzazioni all'interno del IAM ruolo utilizzato durante la configurazione. AWS Config In caso contrario, potrebbe interferire con le operazioni AWS di Control Tower.
Per ulteriori informazioni sui IAM ruoli per AWS Config, vedere AWS Identity and Access Management.
Per creare un ruolo per un AWS servizio
Accedi a AWS Management Console e apri la IAM console all'indirizzo https://console.aws.amazon.com/iam/
. -
Nel riquadro di navigazione della IAM console, scegli Ruoli, quindi scegli Crea ruolo.
-
In Seleziona tipo di entità attendibile, scegli Servizio AWS .
-
Scegli il caso d'uso che desideri AWS Config: Config - Customizable, Config - Organizations, Config o Config - Conformance Packs. Quindi, seleziona Next (Successivo).
-
Nella pagina Nomina, verifica e crea, controlla i dettagli del ruolo e seleziona Crea ruolo.
Per utilizzare un AWS SDK, è necessario configurarlo con le proprie credenziali. Per ulteriori informazioni, consulta I file di configurazione e credenziali condivisi nella AWS SDKs and Tools Reference Guide.
I seguenti esempi di codice mostrano come utilizzare. CreateRole