Installare Documenti intelligenti

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:

  1. 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" ]
  2. 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 aggiungere mocktarget.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 di Bad Request-Hostname not permitted.
    Interfaccia di creazione KVM Nota: se non aggiungi e configuri questa KVM, il proxy non applicherà la lista consentita. Ciò potrebbe comportare l'accesso non autorizzato ai tuoi host e ai tuoi indirizzi IP. Solo i nomi host e gli indirizzi IP degli endpoint API documentati con SmartDocumenti devono essere inclusi nei valori "allowed_hosts".