Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione
Documentazione di Apigee X. Informazioni
Un'organizzazione è il container di primo livello in Apigee Edge. Contiene tutti i proxy API e risorse correlate. Mentre il resto di questo argomento approfondisce le organizzazioni, ecco alcuni punti pratici:
- Per impostazione predefinita, il nome dell'organizzazione è incluso nell'URL utilizzato per chiamare i proxy API,
descritto in Informazioni sugli host virtuali.
Ad esempio:
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- Il nome della tua organizzazione è nell'URL della UI di gestione perimetrale. Ad esempio, il seguente URL mostra i proxy API per l'organizzazione
docs:
- Anche se hai creato una sola organizzazione, puoi appartenere ad altre organizzazioni come a un utente o a un amministratore con autorizzazioni specifiche. Nella UI di gestione perimetrale, se appartieni in 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 nell'amministratore dell'organizzazione
, l'organizzazione è una parte obbligatoria del percorso nella maggior parte delle chiamate. Ad esempio,
La richiesta cURL dell'API di gestione restituisce un elenco di tutti i proxy API di 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 una un'architettura multi-tenancy per la gestione delle API.
Componenti dell'organizzazione
Quando crei un account Edge, Edge crea automaticamente un'organizzazione per te. Una volta creato, puoi aggiungere utenti alla tua organizzazione, creare proxy API e prodotti API registrare sviluppatori e app.
L'immagine seguente mostra i componenti principali del modello organizzativo Edge. Questo definisce la correlazione tra API, prodotti API, app e sviluppatori di app perimetrali.
Questo modello non mostra tutte le funzionalità di Apigee Edge. Se utilizzi la monetizzazione, il modello avrebbe dei componenti aggiuntivi. Per ulteriori informazioni, vedi Panoramica della monetizzazione. Consulta Gestire aziende e sviluppatori per informazioni sulla gestione di società e sviluppatori tramite la monetizzazione.
Nomi delle organizzazioni
Il nome dell'organizzazione è:
- Organizzazione di valutazione:
username-eval - Organizzazione a pagamento: definita dall'utente al momento del provisioning iniziale
Dopo averla creata, non puoi rinominare un'organizzazione.
Il nome dell'organizzazione diventa parte dell'URL dei proxy API e parte dell'URL quando una richiesta all'API Edge Management. Ad esempio, un URL tipico utilizzato per accedere a un'API proxy ha il 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 può essere di test o prod.
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. La un'organizzazione contiene una rappresentazione di tutti i componenti, tra cui proxy API, API prodotti, pacchetti API, app e sviluppatori. I titolari di account non si limitano a una singola organizzazione. Alcuni titolari di account potrebbero definisci o fai parte di più organizzazioni che supportano diversi sviluppatori di app comunità. |
| Ambiente | Un contesto di esecuzione di runtime per i proxy API in un'organizzazione. Consulta la sezione di seguito per saperne di più sugli ambienti. |
|
Utente |
All'interno di un'organizzazione, dove la persona che crea l'account riceve automaticamente amministratore, puoi creare altri utenti. Gli utenti costituiscono il team API dell'organizzazione, che possono includere persone come amministratori, proxy API e creatori di prodotti API, utenti che monitorano analisi e altre statistiche, e così via. Utenti diversi possono avere ruoli e privilegi di accesso diversi. 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 autorizzazioni per creare proxy API e prodotti API, ma senza i privilegi di modificare 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, però, le stesse persone creano tutti i proxy API e prodotti API e e quindi membri di tutte le tue organizzazioni. Non è necessario creare un account Apigee, ovvero creare dell'organizzazione in modo che sia un utente. Un amministratore può aggiungerti a un account dell'organizzazione. 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 un mappatura di un endpoint HTTP disponibile pubblicamente a un servizio di backend. I proxy API possono anche essere configurato per includere la sicurezza (ad esempio OAuth), eseguire la trasformazione dei messaggi (ad esempio da XML a JSON), limitare il traffico ai servizi di backend ed eseguire altre operazioni redditizie sulla richiesta, sulla risposta e con i 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, nel quale viene creato un prodotto API un bundle di proxy API combinati con un piano di servizio. Quel piano di servizio può impostare l'accesso limiti per i proxy API, forniscono sicurezza, consentono il monitoraggio e l'analisi funzionalità aggiuntive. Edge raccoglie dati per l'analisi sui prodotti API. |
|
Sviluppatore |
Un'organizzazione include uno o più sviluppatori che creano le app che utilizzano API (assemblate in prodotti API) definite dalla tua organizzazione. Gli sviluppatori utilizzano le API ma non possono creare API o eseguire altre azioni nell'organizzazione. Gli sviluppatori possono essere interni all'azienda, possono essere partner sviluppatori esterni che pagano per l'accesso alle 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 API, spetta a te stabilire come aggiungere, aggiornare o rimuovere sviluppatori nella tua organizzazione. Puoi aggiungerli manualmente mediante l'interfaccia utente di gestione perimetrale, creare un portale per sviluppatori per registrarli sito web o di definire un meccanismo di registrazione personale utilizzando tramite Google Cloud CLI o tramite l'API Compute Engine. Uno sviluppatore non è tenuto ad avere un account su Edge e la maggior parte degli sviluppatori non solo qualcosa su Edge. Se lo sviluppatore ha un account su Edge, può come utente di un'altra organizzazione, o per usare i servizi API Edge. |
|
App |
Gli sviluppatori creano una o più app client che utilizzano le tue API. Gli sviluppatori devono registrare le loro app nella tua organizzazione. Un'app in Edge è un rappresentazione dell'app effettiva di uno sviluppatore che fornisce allo sviluppatore una chiave API per ogni richiesta alle API. Poiché tutte le app sono registrate nella tua organizzazione, puoi utilizzare Edge per monitorare raccogliere informazioni analitiche sull'app e sul suo utilizzo delle API. |
|
Chiave API/token OAuth |
A seconda del meccanismo di autorizzazione definito per le API, l'app passa una chiave API insieme a ogni richiesta alle API. Se la chiave è valida, la richiesta viene consentito. Edge supporta diversi tipi di autenticazione, tra cui una semplice chiave API, OAuth a due vie, OAuth a tre vie e altri. In qualità di provider API, devi definire un modo in cui gli sviluppatori possono registrare le proprie app. È registrando l'app e restituisci allo sviluppatore la chiave necessaria per accedere al tuo su quelle di livello inferiore. Al momento della registrazione dell'app, lo sviluppatore può scegliere di accedere a una singola API o più prodotti API. L'app effettiva dello sviluppatore utilizza la stessa chiave per accedere Tutti i prodotti API associati all'app (la rappresentazione registrata dei l'app dello sviluppatore su Edge). Puoi revocare la chiave in qualsiasi momento in modo che l'app dello sviluppatore non abbia più accesso alle API (anche se la rappresentazione registrata dell'app dello sviluppatore nella tua organizzazione). In alternativa, puoi definire un limite di tempo su una chiave in modo che lo sviluppatore deve aggiornare la chiave 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'API a un singolo ambiente o a più ambienti.
Un'organizzazione può contenere più ambienti. Ad esempio, puoi definire dev,
test e prod in un'organizzazione.
L'organizzazione fornisce l'ambito per alcune funzionalità Apigee. Ad esempio, mappa chiave-valore (KVM) i dati possono essere resi disponibili a livello di organizzazione, il che significa che i proxy API sono stati distribuiti riceverebbe gli stessi dati da una KVM. Alcune funzionalità, come la memorizzazione nella cache, possono essere all'organizzazione o a un ambiente specifico al suo interno. 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 quelli definiti specificamente per un ambiente:
