Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Un'organizzazione è il container di primo livello in Apigee Edge. Contiene tutti i proxy API e le risorse correlate. Sebbene il resto di questo argomento approfondisca le organizzazioni, ecco alcuni punti pratici:
- Per impostazione predefinita, il nome della tua organizzazione è incluso nell'URL utilizzato per chiamare i proxy API, come descritto in Informazioni sugli host virtuali.
Ad esempio:
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- Il nome della tua organizzazione si trova nell'URL dell'UI di gestione perimetrale. Ad esempio, l'URL seguente mostra i proxy API per l'organizzazione
docs:
- Anche se hai creato una sola organizzazione, puoi appartenere ad altre organizzazioni in qualità di utente o amministratore con autorizzazioni specifiche. Se nell'interfaccia utente di gestione perimetrale fai parte di più organizzazioni, puoi passare a un'altra organizzazione, come descritto in Passare da un'organizzazione all'altra.
- Quando effettui chiamate con l'API di gestione come utente con il ruolo Amministratore organizzazione, l'organizzazione è una parte obbligatoria del percorso nella maggior parte delle chiamate. Ad esempio, la seguente
richiesta cURL dell'API di gestione restituisce un elenco di tutti i proxy API in un'organizzazione:
curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address
Video: guarda un breve video per scoprire come le organizzazioni supportano un'architettura multi-tenancy per la gestione delle API.
Componenti dell'organizzazione
Quando crei un account Edge, Edge crea automaticamente un'organizzazione per te. Dopo la creazione, puoi aggiungere utenti alla tua organizzazione, creare proxy API e prodotti API e registrare sviluppatori e app.
L'immagine seguente mostra i componenti principali del modello di organizzazione Edge. Questo modello definisce la relazione tra API, prodotti API, app e sviluppatori di app all'interno di Edge.
Questo modello non mostra tutte le funzionalità di Apigee Edge. Se utilizzi la monetizzazione, il modello avrà componenti aggiuntivi. Per maggiori informazioni, consulta la sezione Panoramica della monetizzazione. Consulta la pagina relativa alla gestione di società e sviluppatori per informazioni sulla gestione di società e sviluppatori con la monetizzazione.
Nomi di organizzazioni
Il nome dell'organizzazione è:
- Organizzazione valutazione:
username-eval - Organizzazione a pagamento:definita dall'utente al momento del provisioning iniziale
Una volta creata, non puoi rinominare un'organizzazione.
Il nome dell'organizzazione diventa parte dell'URL ai proxy API e parte dell'URL quando effettui una richiesta all'API Edge Management. Ad esempio, un URL tipico utilizzato per accedere a un proxy API ha il seguente formato:
http://org-name-env.apigee.net/v1/weather/forecastrss
dove:
- org-name è il nome della tua organizzazione.
- env è l'ambiente di deployment del proxy API, che è di test o di produzione.
Ad esempio:
http://myorg-test.apigee.net/v1/weather/forecastrss
Componenti dell'organizzazione
La tabella seguente descrive in modo più dettagliato i componenti del modello organizzativo:
| Componente | Descrizione |
|---|---|
|
Organizzazione |
Ogni account Apigee è mappato a una o più organizzazioni su Apigee Edge. L'organizzazione contiene una rappresentazione di tutti i componenti, inclusi proxy API, prodotti API, pacchetti API, app e sviluppatori. I titolari di account non sono limitati a una singola organizzazione. Alcuni proprietari di account potrebbero definire o far parte di più organizzazioni che supportano diverse community di sviluppatori di app. |
| Ambiente | Un contesto di esecuzione di runtime per i proxy API in un'organizzazione. Per saperne di più sugli ambienti, consulta la sezione seguente. |
|
Utente |
All'interno di un'organizzazione, dove la persona che crea l'account è automaticamente amministratore, puoi creare altri utenti. Gli utenti costituiscono il team dedicato alle API dell'organizzazione, che può includere persone quali amministratori, creatori di prodotti API e proxy API, utenti che monitorano le analisi e altre statistiche e qualsiasi altra. Ogni utente può avere ruoli e privilegi di accesso differenti. Ad esempio, definisci alcuni utenti come amministratori dell'organizzazione e amministratori operativi con privilegi per modificare l'organizzazione e i suoi componenti. Definisci altri utenti con le autorizzazioni per creare proxy API e prodotti API, ma senza i privilegi per modificare altri utenti. Gli utenti possono essere membri di più organizzazioni. Ad esempio, la tua azienda potrebbe definire più organizzazioni su Apigee Edge per supportare diverse community di sviluppatori. Internamente, tuttavia, le stesse persone creano tutti i proxy API e i prodotti API e sono quindi membri di tutte le tue organizzazioni. Non è necessario creare un account Apigee, ovvero creare un'organizzazione Apigee, per essere un utente. Un amministratore può aggiungerti a un'organizzazione esistente. Tutti gli utenti accedono ad Apigee Edge qui: https://enterprise.apigee.com. |
|
proxy API |
Gli utenti di un'organizzazione creano uno o più proxy API. Un proxy API definisce una mappatura di un endpoint HTTP disponibile pubblicamente a un servizio di backend. I proxy API possono anche essere configurati in modo da includere la sicurezza (come OAuth), eseguire la trasformazione dei messaggi (ad esempio da XML a JSON), limitare il traffico ai servizi di backend ed eseguire altre operazioni importanti su richiesta, risposta e callout di servizio. Edge raccoglie i dati per l'analisi sui proxy API. |
|
Prodotto API |
Gli utenti di un'organizzazione creano uno o più prodotti API, dove un prodotto API è un bundle di proxy API combinato con un piano di servizio. Tale piano di servizio può impostare limiti di accesso sui proxy API, fornire sicurezza, consentire monitoraggio e analisi e fornire funzionalità aggiuntive. Edge raccoglie i dati per l'analisi sui prodotti basati su API. |
|
Sviluppatore |
Un'organizzazione contiene uno o più sviluppatori che creano le app che utilizzano le API (assemblate in prodotti API) definite dalla tua organizzazione. Gli sviluppatori utilizzano le API ma non possono crearle né eseguire altre azioni nell'organizzazione. Gli sviluppatori possono essere interni all'azienda, possono essere partner o essere sviluppatori esterni che pagano per l'accesso alle tue API. Gli sviluppatori devono essere registrati nella tua organizzazione prima di poter registrare un'app e ricevere una chiave API per accedere alle tue API. In qualità di provider di API, spetta a te determinare come aggiungere, aggiornare o rimuovere gli sviluppatori nella tua organizzazione. Puoi aggiungerli manualmente tramite l'interfaccia utente di gestione perimetrale, creare un portale per gli sviluppatori per registrarli tramite un sito web oppure definire il tuo meccanismo di registrazione personale utilizzando l'API di gestione Edge. Uno sviluppatore non deve necessariamente avere un account su Edge e la maggior parte degli sviluppatori non avrà bisogno di sapere nulla di Edge. Se lo sviluppatore ha un account su Edge, di solito è un utente di un'altra organizzazione oppure deve utilizzare i servizi API Edge. |
|
App |
Gli sviluppatori creano una o più app client che utilizzano le tue API. Gli sviluppatori devono registrare le proprie app presso la tua organizzazione. Un'app in Edge è una rappresentazione dell'app effettiva di uno sviluppatore che fornisce allo sviluppatore una chiave API da passare con ogni richiesta alle tue API. Poiché tutte le app sono registrate nella tua organizzazione, puoi utilizzare Edge per monitorare e raccogliere informazioni di analisi sull'app e sul suo utilizzo delle API. |
|
Chiave API/token OAuth |
A seconda del meccanismo di autorizzazione che definisci per le tue API, l'app passa una chiave API insieme a ogni richiesta alle tue API. Se la chiave è valida, la richiesta è consentita. Edge supporta diversi tipi di autenticazione, ad esempio una chiave API semplice, OAuth a due vie, OAuth a tre vie e altri. In qualità di provider di API, devi definire un modo in cui gli sviluppatori possono registrare le loro app. Registrando l'app si restituisce allo sviluppatore la chiave necessaria per accedere alle API. Al momento della registrazione dell'app, lo sviluppatore può scegliere di accedere a un singolo prodotto API o a più prodotti API. L'app effettiva dello sviluppatore utilizza la stessa chiave per accedere a tutti i prodotti API associati all'app (la rappresentazione registrata dell'app dello sviluppatore in Edge). Puoi revocare la chiave in qualsiasi momento in modo che l'app dello sviluppatore non abbia più accesso alle tue API (anche se nella tua organizzazione esiste ancora la rappresentazione registrata dell'app dello sviluppatore). In alternativa, puoi definire un limite di tempo su una chiave in modo che lo sviluppatore debba aggiornarla dopo un intervallo di tempo specifico. |
Informazioni sugli ambienti
Un ambiente è un contesto di esecuzione di runtime per i proxy API in un'organizzazione. Devi eseguire il deployment di un proxy API in un ambiente prima di potervi accedere. Puoi eseguire il deployment di un proxy API in un singolo ambiente o in più ambienti.
Un'organizzazione può contenere più ambienti. Ad esempio, potresti definire un ambiente dev,
test e prod in un'organizzazione.
L'organizzazione fornisce l'ambito per alcune funzionalità di Apigee. Ad esempio, i dati delle mappe chiave-valore (KVM) possono essere resi disponibili a livello di organizzazione, il che significa che i proxy API di cui è stato eseguito il deployment in qualsiasi ambiente ricevono gli stessi dati da KVM. Alcune funzionalità, come la memorizzazione nella cache, possono limitare l'ambito all'organizzazione o a un ambiente specifico all'interno dell'organizzazione. I dati di analisi di Apigee sono partizionati in base a una combinazione di organizzazione e ambiente.
Di seguito sono riportate le principali entità che gestisci all'interno di un'organizzazione, incluse quelle definite a livello globale nell'organizzazione e quelle definite specificamente per un ambiente:
