Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
Un'organizzazione è il contenitore di primo livello in Apigee Edge. Contiene tutti i proxy API e le risorse correlate. Mentre il resto di questo argomento approfondisce le organizzazioni, di seguito sono riportati alcuni punti pratici:
- Per impostazione predefinita, il nome dell'organizzazione è nell'URL utilizzato per chiamare i proxy API, come описано в 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 potresti aver creato una sola organizzazione, puoi appartenere ad altre organizzazioni come un utente o un amministratore con autorizzazioni specifiche. Nell'interfaccia utente di gestione di Edge, se appartieni a più organizzazioni, puoi passare a un'altra come descritto in Passare da un'organizzazione all'altra.
- Quando effettui chiamate con l'API di gestione come utente con il ruolo Amministratore dell'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 in che modo 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. Una volta creata, puoi aggiungere utenti alla tua organizzazione, creare proxy API e prodotti API e registrare sviluppatori e app.
L'immagine seguente mostra i principali componenti del modello di organizzazione di Edge. Questo modello definisce il modo in cui le tue API, i tuoi prodotti API, le tue app e gli sviluppatori di app sono correlati all'interno di Edge.
Questo modello non mostra tutte le funzionalità di Apigee Edge. Se utilizzi la monetizzazione, il modello avrà componenti aggiuntivi. Per ulteriori informazioni, consulta la panoramica della monetizzazione. Consulta la sezione Gestire aziende e sviluppatori per informazioni sulla gestione di aziende e sviluppatori con 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 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 può essere test o 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 dell'account non sono limitati a una singola organizzazione. Alcuni titolari di account potrebbero definire o far parte di più organizzazioni che supportano diverse comunità 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 riportata di seguito. |
|
Utente |
All'interno di un'organizzazione, in cui la persona che crea l'account è automaticamente un amministratore, puoi creare altri utenti. Gli utenti costituiscono il team API dell'organizzazione, che può includere persone come amministratori, creator di prodotti API e proxy API, utenti che monitorano analisi e altre statistiche e altri ancora. 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 relativi componenti. Definisci altri utenti con 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. Tuttavia, internamente, sono le stesse persone a creare tutti i proxy e i prodotti API e sono quindi membri di tutte le tue organizzazioni. Non è necessario creare un account Apigee, ovvero un'organizzazione Apigee, per essere 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 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 utili sulla richiesta, sulla risposta e con i callout del servizio. Edge raccoglie i dati per l'analisi sui proxy API. |
|
Prodotto API |
Gli utenti di un'organizzazione creano uno o più prodotti API, ovvero un insieme di proxy API combinati con un piano di servizio. Questo piano di servizio può impostare limiti di accesso ai proxy API, fornire sicurezza, consentire il monitoraggio e l'analisi e offrire funzionalità aggiuntive. Edge raccoglie i dati per le analisi sui prodotti 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, partner o 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 fornitore di API, spetta a te stabilire come aggiungere, aggiornare o rimuovere gli sviluppatori nella tua organizzazione. Puoi aggiungerli manualmente tramite l'interfaccia utente di Edge Management, creare un portale per gli sviluppatori per registrarli tramite un sito web o definire un meccanismo di registrazione personale utilizzando l'API Edge Management. Uno sviluppatore non è tenuto ad avere un account su Edge e la maggior parte degli sviluppatori non dovrà sapere nulla di Edge. Se lo sviluppatore ha un account su Edge, solitamente è un utente di un'altra organizzazione o utilizza i servizi API di Edge. |
|
App |
Gli sviluppatori creano una o più app client che utilizzano le tue API. Gli sviluppatori devono registrare le proprie app nella tua organizzazione. Un'app in Edge è una representatione 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 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 è consentita. Edge supporta diversi tipi di autenticazione, ad esempio una semplice chiave API, OAuth a due vie, OAuth a tre vie e altri. In qualità di provider di API, devi definire un modo per consentire agli sviluppatori di registrare le loro app. È tramite la registrazione dell'app che restituisci allo sviluppatore la chiave necessaria per accedere alle tue 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 la rappresentazione registrata dell'app dello sviluppatore esiste ancora nella tua organizzazione). In alternativa, puoi definire un limite di tempo per una chiave in modo che lo sviluppatore debba 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 proxy API in un singolo ambiente o in più ambienti.
Un'organizzazione può contenere più ambienti. Ad esempio, in un'organizzazione potresti definire un ambiente dev,
test e prod.
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 riceveranno gli stessi dati dalla KVM. Alcune funzionalità, come la memorizzazione nella cache, possono essere limitate 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:
