Aller au contenu principal
Connexion
Deutsch English (United States) Español Italiano

Inscription aux GSuite APIs & Services

GSuite propose une intégration via les API oAuth-2. Ce guide couvre les étapes nécessaires pour accorder à votre Libraesva Email Security Gateway les autorisations sur votre GSuite Tenant. Aucune modification n'est apportée au GSuite Tenant lui-même par Libraesva Email Security Gateway.

Préparation du GSuite Tenant

  1. Ouvrez Google Developer Console (https://console.developers.google.com/) et connectez-vous avec vos identifiants GSuite
  2. Dans le menu déroulant, sélectionnez votre organisation puis CREATE a PROJECT
  3. Créez un nouveau projet nommé Libraesva ESG S
  4. Sélectionnez le projet que vous venez de créer
  5. Activez l'Admin SDK API
    1. Recherchez « Admin SDK API » à l'aide de la barre de recherche en haut
    2. Cliquez sur le premier résultat « Admin SDK API »
    3. Activez-le
  6. Activez la Gmail API si vous souhaitez utiliser le Threat Remediation
    1. Recherchez « Gmail API » à l'aide de la barre de recherche en haut
    2. Cliquez sur le premier résultat « Gmail API »
    3. Activez-la
  7. Activez « OAuth consent screen »
    1. Depuis le menu de navigation, allez dans API and Services -> OAuth consent screen
    2. Sélectionnez le User Type « Internal » et cliquez sur « Create »
    3. Saisissez le nom de l'application, appelez-la « Libraesva ESG »
    4. Renseignez un « User support email » et les « Developer contact information »
    5. Cliquez sur Save & Continue
    6. Ne renseignez aucun Scope et cliquez à nouveau sur « Save & Continue »
    7. Cliquez sur BACK TO DASHBOARD

OAuth2 Client ID et Secret

  1. Allez dans le menu « APIs and Services -> Credentials »
  2. Choisissez « Create Credentials » -> « OAuth Client ID »
  3. Choisissez « Web application » comme type
  4. Appelez-le « Libraesva ESG Authentication »
  5. Ajoutez HTTPS://<esg public fqdn>/oauth-login comme « Authorized redirect URI » et cliquez sur Create
  6. Notez le Client ID et le Client Secret

Service Account

×L'étape 3 est également décrite sur cette page officielle de la documentation Google : https://developers.google.com/admin-sdk/directory/v1/guides/delegation
  1. Créez un nouveau Service Account
    1. Depuis le Navigation Menu, allez dans IAM & Admin – Service Accounts
    2. Cliquez sur Create Service Account
    3. Appelez-le libraesvaesg
    4. Continuez avec les paramètres par défaut et enregistrez
    5. Notez le Service Account Email
  2. Obtenez une clé pour le Service Account
    1. Cliquez sur le « Service Account » créé ci-dessus
    2. Notez l'Unique Id
    3. Sélectionnez « ADD KEY » -> « Create new key »
    4. Sélectionnez le type « JSON »
    5. Générez-la et téléchargez la clé JSON
    6. Ouvrez le fichier JSON avec un éditeur de texte et notez le private_key entre les guillemets
  3. Autorisez le Service Account à accéder à votre annuaire
    1. Allez dans votre console d'administration GSuite (https://admin.google.com/)
    2. Cliquez sur « Security -> Access and data control->API Controls ->Manage Domain Wide Delegation »
    3. Ajoutez un enregistrement avec « Add New »
    4. Renseignez le champ « Client ID » avec l'Unique Id copié précédemment
    5. Copiez le texte suivant et collez-le dans le champ « Oauth Scopes » https://www.googleapis.com/auth/admin.directory.user,https://www.googleapis.com/auth/admin.directory.group
    6. Fournissez également le scope https://mail.google.com/ pour accorder les autorisations nécessaires au Threat Remediation
    7. Cliquez sur authorize

ID du tenant G Suite

Trouvez votre Organization Id en accédant à cette page https://play.google.com/work/adminsettings?pli=1 (vous pouvez également le trouver dans la console d'administration, consultez le guide suivant https://krypted.com/uncategorized/get-your-customerid-from-g-suite/ )

Paramètres pour Threat Remediation

×NOTE : suivez ce guide si vous avez déjà créé un G Suite Connector et que vous souhaitez uniquement ajouter l'autorisation nécessaire pour le Threat Remediation
  1. Activez la Gmail API
    1. Ouvrez Google Developer Console (https://console.developers.google.com/) et connectez-vous avec vos identifiants GSuite
    2. Dans le menu déroulant, sélectionnez le projet créé pour le G Suite Connector
    3. Recherchez « Gmail API » à l'aide de la barre de recherche en haut
    4. Cliquez sur le premier résultat « Gmail API »
    5. Activez-la
  2. Ajoutez le scope nécessaire pour le rappel d'e-mail
    1. Allez dans votre console d'administration GSuite (https://admin.google.com/)
    2. Cliquez sur « Security -> API Controls -> Manage Domain Wide Delegation »
    3. Trouvez le Service Account déjà créé par « Client ID » et cliquez sur Edit
    4. Ajoutez le scope https://mail.google.com/
    5. Cliquez sur authorize

Articles associés