Vai al contenuto principale
Accedi
Deutsch English (United States) Español Français

Registrazione API e Servizi GSuite

GSuite offre l'integrazione tramite API oAuth-2. Questa guida illustra i passaggi necessari per concedere al tuo Libraesva Email Security Gateway le autorizzazioni sul tuo Tenant GSuite. Libraesva Email Security Gateway non apporta alcuna modifica al Tenant GSuite stesso.

Preparazione del Tenant GSuite

  1. Apri Google Developer Console (https://console.developers.google.com/) e accedi con le tue credenziali GSuite
  2. Dal menu a tendina seleziona la tua Organizzazione e poi CREATE a PROJECT
  3. Crea un nuovo progetto chiamato Libraesva ESG S
  4. Seleziona il progetto appena creato
  5. Abilita la Admin SDK API
    1. Cerca “Admin SDK API” usando la barra di ricerca in alto
    2. Fai clic sul primo risultato “Admin SDK API“
    3. Abilitala
  6. Abilita la Gmail API se desideri utilizzare il Threat Remediation
    1. Cerca “Gmail API” usando la barra di ricerca in alto
    2. Fai clic sul primo risultato “Gmail API“
    3. Abilitala
  7. Abilita “OAuth consent screen”
    1. Dal Menu di navigazione, vai su API and Services -> OAuth consent screen
    2. Seleziona il tipo di utente “Internal” e fai clic su “Create”
    3. Inserisci il nome dell'applicazione, chiamala “Libraesva ESG”
    4. Fornisci un “User support email” e le “Developer contact information”
    5. Fai clic su Save & Continue
    6. Non fornire alcuno Scope e fai di nuovo clic su “Save & Continue”
    7. Fai clic su BACK TO DASHBOARD

Client ID e Secret OAuth2

  1. Vai al menu “APIs and Services -> Credentials”
  2. Scegli “Create Credentials” -> “OAuth Client ID”
  3. Scegli “Web application” come tipo
  4. Chiamalo “Libraesva ESG Authentication”
  5. Aggiungi HTTPS://<esg public fqdn>/oauth-login come “Authorized redirect URI” e fai clic su Create
  6. Prendi nota del Client ID e del Client Secret

Service Account

×Il passaggio 3 e' descritto anche in questa pagina ufficiale della documentazione google: https://developers.google.com/admin-sdk/directory/v1/guides/delegation
  1. Crea un nuovo service account
    1. Dal Navigation Menu, vai su IAM & Admin – Service Accounts
    2. Fai clic su Create Service Account
    3. Chiamalo libraesvaesg
    4. Continua con le impostazioni predefinite e salva
    5. Prendi nota del Service Account Email
  2. Ottieni una chiave per il service account
    1. Fai clic sul “Service Account” creato sopra
    2. Prendi nota dell'Unique Id
    3. Seleziona “ADD KEY” -> “Create new key”
    4. Seleziona il tipo “JSON”
    5. Generala e scarica la chiave JSON
    6. Apri il file JSON con un editor di testo e prendi nota della private_key racchiusa tra le virgolette
  3. Consenti al service account di accedere alla tua directory
    1. Vai alla tua console di amministrazione GSuite (https://admin.google.com/)
    2. Fai clic su “Security -> Access and data control->API Controls ->Manage Domain Wide Delegation”
    3. Aggiungi un record con “Add New”
    4. Compila il campo “Client ID” con l'Unique Id copiato in precedenza
    5. Copia il seguente testo e incollalo nel campo “Oauth Scopes” https://www.googleapis.com/auth/admin.directory.user,https://www.googleapis.com/auth/admin.directory.group
    6. Fornisci anche lo scope https://mail.google.com/ per concedere le autorizzazioni necessarie per il Threat Remediation
    7. Fai clic su authorize

ID Tenant G Suite

Trova il tuo Organization Id andando su questa pagina https://play.google.com/work/adminsettings?pli=1 (puoi trovarlo anche nella Admin console, consulta la seguente guida https://krypted.com/uncategorized/get-your-customerid-from-g-suite/ )

Impostazioni per il Threat Remediation

×NOTA: segui questa guida se hai già creato un G Suite Connector e desideri solo aggiungere l'autorizzazione necessaria per il Threat Remediation
  1. Abilita la Gmail API
    1. Apri Google Developer Console (https://console.developers.google.com/) e accedi con le tue credenziali GSuite
    2. Dal menu a tendina, seleziona il progetto creato per il G Suite Connector
    3. Cerca “Gmail API” usando la barra di ricerca in alto
    4. Fai clic sul primo risultato “Gmail API“
    5. Abilitala
  2. Aggiungi lo scope necessario per il richiamo delle email
    1. Vai alla tua console di amministrazione GSuite (https://admin.google.com/)
    2. Fai clic su “Security -> API Controls -> Manage Domain Wide Delegation”
    3. Trova il service account già creato tramite “Client ID” e fai clic su Edit
    4. Aggiungi lo scope https://mail.google.com/
    5. Fai clic su authorize

Articoli correlati