SmartDocumenti viene installato automaticamente quando installi ed esegui gli script per il test di installazione descritti in Eseguire il test dell'installazione. Nell'esecuzione degli script di test, esegui questi comandi:
/opt/apigee/apigee-service/bin/apigee-service apigee-validate install
/opt/apigee/apigee-service/bin/apigee-service apigee-validate setup -f configFile
Dove configFile è lo stesso file di configurazione utilizzato per installare Edge. Per ulteriori informazioni, consulta Installare i componenti perimetrali su un nodo.
Questo comando installa SmartDocumenti durante l'esecuzione dei test.
Per completare l'installazione:
Verifica che SmartDocumenti sia installato verificando che il file
smartdocs.zip
si trovi nella seguente directory:/opt/apigee/apigee-validate/bundles/
Oppure esegui la seguente chiamata API sul nodo Management Server:
curl -v -u adminEmail:adminPword 0:8080/v1/o/validate/apis
Questo comando dovrebbe restituire il seguente codice se SmartDocumenti è installato:
[ "smartdocs", "passthrough" ]
- Dall'interfaccia utente di Edge, crea e aggiorna una KVM denominata "smartdocs_Whitelist", come mostrato nella figura seguente.
La KVM deve essere creata nell'organizzazione e nell'ambiente in cui è attualmente eseguito il deployment del proxy SmartDocumenti.
Nota: assicurati che la casella criptata NON sia selezionata.
- Aggiungi una chiave denominata "is_Whitelist_configure", dove il valore è "YES".
- Aggiungi una seconda chiave denominata "allowed_hosts", in cui i valori corrispondono a nomi host separati da spazi o indirizzi IP chiamati da SmartDocumenti. Il valore di "allowed_hosts" dovrebbe includere qualsiasi host incluso nelle specifiche OpenAPI aggiunte a SmartDocumenti. Ad esempio, se hai una specifica OpenAPI che chiama
mocktarget.apigee.net
, dovrai aggiungeremocktarget.apigee.net
al valore "allowed_hosts". Se un host non è incluso nella KVM, la risposta SmartDocumenti sarà400 Bad Request
con un payload di contenuti diBad Request-Hostname not permitted
.