Configurazione e convalida di un IP in uscita dedicato in AEM as a Cloud Service

La configurazione dell’IP di uscita dedicato in AEM as a Cloud Service confonde i clienti perché la creazione avviene a livello di programma, ma l’IP non è attivo per il traffico in uscita finché non viene esplicitamente abilitato per ogni ambiente. L’IP dedicato non viene mai visualizzato nell’interfaccia utente di Cloud Manager; viene recuperato tramite una ricerca DNS rispetto al nome host esterno del programma. I ritardi nel provisioning e gli errori di quota di Cloud Manager contribuiscono a creare confusione. La creazione dell’infrastruttura di rete, l’abilitazione in ciascun ambiente, la risoluzione dell’IP tramite DNS e la conferma del traffico in uscita utilizzano tale IP per completare una configurazione di inserisco nell’elenco Consentiti di rete di lavoro di tipo.

Descrizione description

Problema: l’IP in uscita dedicato non può essere individuato o non instrada il traffico in uscita in AEM as a Cloud Service

Descrizione

Durante la configurazione degli indirizzi IP di uscita dedicati in Cloud Manager, i clienti non possono individuare l’interfaccia utente di configurazione corretta, riscontrare un comportamento imprevisto dell’interfaccia utente o non sono sicuri di come recuperare l’IP di uscita finale da inserire nell’elenco Consentiti per i sistemi esterni. In Cloud Manager vengono visualizzati errori quali An error occurred while triggering network creation, Only one network infrastructure per program is allowed o NETWORK_INFRASTRUCTURES_EXCEEDS_LIMIT. I clienti devono anche convalidare l’indirizzo IP utilizzato da AEM per le chiamate in uscita (HTTP/HTTPS o SMTP), in particolare per la inserisce nell’elenco Consentiti dei firewall o dei WAF. Il problema si verifica quando la funzione non è completamente predisposta o non è ancora abilitata a livello di ambiente o quando la creazione dell’infrastruttura a livello di programma viene confusa con l’abilitazione a livello di ambiente.

Ambiente:

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Assets Essentials
  • Cloud Manager (rete avanzata)

Problema/Sintomi:

  • Cloud Manager visualizza errori quali An error occurred while triggering network creation o Only one network infrastructure per program is allowed.
  • L’indirizzo IP di uscita dedicato non è presente nell’interfaccia utente e l’IP non viene visualizzato in Cloud Manager.
  • Le connessioni in uscita a sistemi di terze parti sono bloccate a causa di IP di origine non riconosciuti, causando errori 403/503 o rifiuti WAF.
  • L’infrastruttura IP in uscita dedicata sembra essere stata creata, ma il traffico in uscita non utilizza l’IP di origine previsto.

Causa principale:

AEM as a Cloud Service utilizza Cloud Manager per il provisioning di funzioni di rete avanzate. La creazione di un IP in uscita dedicato avviene a livello di programma, ma l’IP non è attivo per il traffico in uscita finché non viene esplicitamente abilitato per ogni ambiente. L’IP dedicato non viene visualizzato nell’interfaccia utente; deve invece essere risolto tramite una ricerca DNS. Un’interpretazione errata di questi passaggi, combinata con differenze nell’interfaccia utente di Cloud Manager e ritardi nel provisioning fino a una o due ore, porta a confusione o a inserire nell’elenco Consentiti in uscita non riuscite. Alcuni errori di Cloud Manager si verificano quando si tenta di creare più infrastrutture in un programma o quando vengono superate le quote.

Come confermare

  1. Verifica lo stato del provisioning. Accedi a Cloud Manager, seleziona il programma, apri la scheda Ambienti e scegli Infrastruttura di rete nella barra laterale a sinistra. Viene visualizzato un record per Indirizzo IP in uscita dedicato con stato ready o provisioning.

  2. Recupera l’IP in uscita dedicato con una ricerca DNS locale, sostituendo {programId} con il tuo ID programma:

    code language-none
    dig +short p{programId}.external.adobeaemcloud.com
    

Il comando restituisce un singolo indirizzo IP pubblico. Se il record restituisce vuoto, il provisioning non è ancora stato completato.

Risoluzione resolution

  1. Creare l’infrastruttura IP in uscita dedicata. In Cloud Manager, vai a Ambienti > Infrastruttura di rete > Aggiungi infrastruttura di rete, seleziona Indirizzo IP in uscita dedicato, scegli un’area geografica e fai clic su Salva. Viene visualizzata una nuova voce e il suo stato diventa ready entro circa 15-60 minuti. Se Cloud Manager restituisce An error occurred while triggering network creation o NETWORK_INFRASTRUCTURES_EXCEEDS_LIMIT, risolvere le autorizzazioni o rimuovere un’infrastruttura esistente, poiché è consentita una sola infrastruttura di rete per programma.

  2. Abilita l’IP di uscita dedicato a livello di ambiente. Vai a Ambienti, seleziona l’ambiente specifico (Dev/Stage/Prod), apri Rete avanzata, abilita l’infrastruttura di rete e fai clic su Salva. In Infrastruttura di rete, verificare che la colonna Ambienti mostri l’ambiente come abilitato. Se non viene aggiornato, confermare di aver premuto Salva nella finestra di dialogo a livello di ambiente.

  3. Recupera l’IP in uscita dedicato e confermalo. Esegui la ricerca DNS e verifica che l’IP restituito corrisponda al valore visualizzato nei registri o tramite un servizio di eco remoto:

    code language-none
    dig +short p{programId}.external.adobeaemcloud.com
    
  4. Verifica che il traffico in uscita utilizzi l’IP in uscita dedicato. Dal codice AEM o da un client HTTP che utilizza le proprietà proxy di sistema, chiamare un servizio echo o il sistema di destinazione, quindi confermare che la destinazione registra lo stesso IP restituito dal comando dig. Verificare che il codice client utilizzi le impostazioni proxy di sistema, ad esempio HttpClientBuilder.useSystemProperties().

  5. Se necessario, configura il traffico SMTP o altro traffico non HTTP/HTTPS. Per le porte SMTP o personalizzate, inviare una definizione JSON portForwards in Cloud Manager. I registri di terze parti confermano che le richieste arrivano dall’IP dedicato. Se le connessioni non riescono, convalidare le definizioni di port forwarding e riprovare quando l’infrastruttura raggiunge uno stato pronto.

Convalida

  1. Esegui la ricerca DNS e verifica che restituisca l’IP previsto:

    code language-none
    dig +short p{programId}.external.adobeaemcloud.com
    
  2. Esegui una chiamata HTTP di prova da AEM a un servizio echo e conferma che l’IP restituito corrisponda all’IP in uscita dedicato.

  3. Conferma i sistemi di terze parti (SMTP, WAF, CRM e simili) ora registrano il traffico in entrata dall’IP dedicato.

Lettura correlata

recommendation-more-help
experience-cloud-kcs-help-kbarticles