Guida introduttiva

Questa pagina spiega come gli sviluppatori possono iniziare a utilizzare le API Cloud de Confiance by S3NS .

Se utilizzi le API Cloud de Confiance per la prima volta, puoi seguire i passaggi di questa guida per chiamare le API utilizzando i comandi curl. Puoi utilizzare i comandi curl per sperimentare un'API prima di sviluppare l'applicazione.

Creazione di un progetto S3NS

Per utilizzare le API Cloud de Confiance , devi disporre di un account utente (un accountS3NS o un account di un provider di identità esterno) e di un progettoS3NS . Un progetto equivale a un account sviluppatore. Funge da contenitore di risorse per le tue risorse Cloud de Confiance . Fornisce inoltre un limite di isolamento per l'utilizzo dei servizi Cloud de Confiance by S3NS , in modo da poter gestire i limiti di quota e la fatturazione in modo indipendente a livello di progetto. Anche la telemetria e le dashboard di utilizzo sono raggruppate per progetti. Se non hai ancora un progetto, puoi crearne uno utilizzando la consoleCloud de Confiance .

Un progetto può essere proprietario di un'ampia gamma di risorse, tra cui chiavi API, client OAuth, service account, VM Compute Engine, bucket Cloud Storage e set di dati BigQuery. Quando un'applicazione chiama un'API Cloud de Confiance , il progetto proprietario delle credenziali dell'applicazione è chiamato progetto client, mentre il progetto proprietario della risorsa di destinazione è chiamato progetto risorsa. Se una richiesta API tocca più risorse, sono coinvolti più progetti di risorse.

Se vuoi interrompere l'utilizzo di Cloud de Confiance per qualsiasi motivo, puoi utilizzare la consoleCloud de Confiance per eliminare il progetto. Il tuo progetto e tutte le risorse al suo interno verranno eliminati dopo il periodo di conservazione. Tieni presente che i diversi tipi di dati hanno periodi di conservazione diversi.

Individuare le API

Prima di utilizzare qualsiasi API Cloud de Confiance , devi utilizzare la libreria API della console Cloud de Confiance per sfogliare le APICloud de Confiance disponibili e scoprire quelle più adatte alle tue esigenze aziendali.

Abilitazione delle API in corso…

Alcune Cloud de Confiance API sono abilitate per impostazione predefinita. Per utilizzare un'API Cloud de Confiance che non è abilitata per impostazione predefinita, devi abilitarla per il tuo progetto. A seconda dei servizi e dei progetti coinvolti nella tua applicazione, inclusi il progetto client e i progetti di risorse, potrebbe essere necessario abilitare un'API per più progetti. Quando abiliti un'API che dipende da altre API, queste vengono abilitate contemporaneamente.

Per abilitare un'API, devi accettare i Termini di servizio e la responsabilità di fatturazione per l'API. Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable per il progetto. Per saperne di più, consulta la sezione Controllo dell'accesso di Service Usage .

Per abilitare un'API per un progetto utilizzando la console:

  1. Vai alla libreria API della consoleCloud de Confiance .
  2. Dall'elenco dei progetti, seleziona quello che vuoi utilizzare.
  3. Nella libreria API, seleziona l'API che vuoi abilitare. Se hai bisogno di aiuto per trovare l'API, utilizza il campo di ricerca e i filtri.
  4. Nella pagina dell'API, fai clic su ABILITA.

Dalla stessa pagina puoi disattivare un'API per il tuo progetto se non la utilizzi più per evitare usi impropri e addebiti di fatturazione accidentali. Puoi anche abilitare e disabilitare le API Cloud utilizzando gcloud CLI e l'API Service Usage:

gcloud services enable pubsub.googleapis.com
gcloud services disable pubsub.googleapis.com

Abilitazione della fatturazione in corso

Alcune API Cloud addebitano l'utilizzo. Prima di poter iniziare a utilizzare queste API nel tuo progetto, devi abilitare la fatturazione per il progetto. L'utilizzo dell'API in un progetto viene addebitato all'account di fatturazione associato al progetto.

Autenticazione nelle API

La modalità di autenticazione a un'API dipende dall'ambiente di sviluppo e dai metodi di autenticazione supportati dall'API.

La configurazione delle Credenziali predefinite dell'applicazione per l'utilizzo in una serie di ambienti è l'approccio più comune ed è consigliato per la maggior parte delle applicazioni. Se l'API supporta le chiavi API, questa è un'altra opzione. Se la tua applicazione deve accedere alle risorse cloud di proprietà degli utenti finali, devi creare un ID client OAuth 2.0 e utilizzare le librerie di autenticazione.

Per informazioni generali sull'autenticazione, vedi Autenticazione su Google.

Creazione di applicazioni

Se stai creando un'applicazione utilizzando le API Cloud, ti consigliamo di utilizzare le librerie clientCloud de Confiance , se disponibili. Per comodità, le librerie client possono gestire le funzionalità API comuni, come autenticazione, gestione degli errori, tentativi e convalida del payload. Devi trasmettere le credenziali dell'applicazione alle librerie client durante l'inizializzazione, in modo che le librerie client possano effettuare chiamate alle APICloud de Confiance per conto della tua applicazione.

Ulteriori informazioni