|
Klassieke bestandstypen zijn vanaf januari 2021 niet meer beschikbaar voor gebruik. U kunt uw klassieke bestanden omzetten of een PDF downloaden. Meer informatie

Workiva-ondersteuningscentrum

Verbinding met Google Cloud Storage

Verbinding met Google Cloud Storage

  • Laatst bijgewerkt op

Met de Google® Cloud Storage-connector kunt u opdrachten in een keten gebruiken om bestanden en mappen in Google Cloud Storage-buckets te beheren.

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons supportteam u kan helpen bij het configureren van deze connector binnen uw werkruimte, kunnen we geen problemen oplossen of anderszins ondersteuning bieden bij problemen die buiten het Workiva-platform ontstaan.

Voorwaarden

Om de verbinding tot stand te brengen, gebruikt de connector de Google Cloud Storage JSON API.Om de connector in te stellen, hebt u het volgende nodig:

  • Een speciale Google Cloud-applicatie voor de connector.
  • De standaard Google Cloud Storage-bucket waarmee u wilt communiceren.

Om de verbinding te beveiligen, kan de applicatie gebruikmaken van OAuth-toestemming of Application Default Credentials (ADC) voor authenticatie. Afhankelijk van de authenticatiemethode heb je mogelijk ook het volgende nodig:

  • Indien OAuth-toestemming vereist is, worden de client-ID en het geheim van de applicatie gebruikt.

  • Als ADC met een CloudRunner, een speciaal serviceaccount voor de applicatie en het bijbehorende application_default_credentials.json credentials-bestand

    Opmerking: Als ADC met een GroundRunner op Google Compute Engine, Google Kubernetes Engine (GKE), App Engine, Cloud Run, of Cloud Functions, kan de connector authenticeren via het standaard serviceaccount van de app.
Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de organisatie deze eerst inschakelen via Configuratie.

Een Google Cloud-applicatie maken

Om de connector in te stellen, moet u eerst een speciale Google Cloud-applicatie voor de connector aanmaken. Om verbinding te maken met de applicatie, gebruikt de connector Google Cloud ADC of OAuth-toestemming.

Stap 1. Selecteer of maak een project aan.

Selecteer of maak in de Google Cloud Platform (GCP)-console een project aan dat u met de connector wilt gebruiken. Om een ​​project te maken:

  1. Klik in de werkbalk op Selecteer een project of de naam van het huidige project en klik vervolgens op Nieuw project.
    google-drive-connector_01.png
  2. Voer in Projectnaameen unieke naam in om de integratie te identificeren.
  3. Selecteer in Locatieuw organisatie zodat anderen het project kunnen gebruiken.
  4. Klik op Maken.
     

Stap 2. Schakel toegang tot de service in.

  1. Selecteer uit API's en services, Bibliotheek.
    google-cloud-storage_04.png
  2. Zoek en selecteer Cloudopslagen klik op Inschakelen.
     

Stap 3. Maak de authenticatiegegevens van de app aan of haal ze op.

Om de applicatie te authenticeren, moet u de inloggegevens voor Google Cloud ADC of OAuth-toestemming aanmaken en ophalen.

Standaard aanmeldgegevens voor Google Cloud-applicaties (ADC)

Als de applicatie draait in een Google Cloud-omgeving zoals Compute Engine, Kubernetes Engine, App Engine, Cloud Run of Cloud Functions, kunt u het standaard serviceaccount van die omgeving gebruiken voor authenticatie. Maak anders een serviceaccount aan en download het bijbehorende inloggegevensbestand voor authenticatie:

  1. Open in de Google Cloud Platform (GCP)-console het optieje om een​​serviceaccountsleutel aan te maken.
    google-cloud-storage_03.png
  2. Selecteer in Serviceaccountde optie Nieuw serviceaccount.
  3. Voer een unieke naam in om het serviceaccount te identificeren.
  4. Selecteer in Rol, Cloudopslag, Opslagobjectbeheerder.
  5. Onder Sleuteltype, selecteer JSON.
  6. Klik op Maken. Het serviceaccount downloadt het bestand application_default_credentials.json . Wanneer je de connector instelt, upload je dit bestand als een bron.
     

OAuth-toestemming

Om de applicatie te authenticeren met behulp van OAuth-toestemming:

  1. Selecteer in API's en serviceshet OAuth-toestemmingsscherm.
  2. Selecteer op het tabblad OAuth-toestemmingsscherm de optie Internen klik op Aanmaken.
    google-drive-connector_02.png
  3. Voer onder App-informatiede naam van de applicatie en het e-mailadres van de gebruikersondersteuning in. Dit helpt bij het identificeren van de app tijdens de authenticatie van de connector.
  4. Voeg onder App-domeineen geautoriseerd domein toe vanwdesk.com.
    google-drive-connector_11.png
  5. Onder Contactgegevens ontwikkelaarvoer je het e-mailadres in waarnaar Google updates over het project moet sturen, en klik je op Opslaan en doorgaan.

  6. Onder Scopes en Optional infoklikt u op Save and Continue zonder scopes of optionele informatie toe te voegen.

    Opmerking: Voor een applicatie met interne gebruikers zijn geen scopes of optionele informatie vereist.
  7. Onder Samenvattingkunt u de details van het OAuth-toestemmingsscherm controleren en bewerken, en vervolgens op Terug naar Dashboardklikken.
  8. Klik op het tabblad Referenties] op Referenties aanmakenen selecteer OAuth-client-ID.
    google-drive-connector_08.png
  9. Selecteer onder Toepassingstypede optie Webtoepassing.
    google-drive-connector_12.png
  10. Voer een unieke naam in om de OAuth-gegevens te identificeren.
  11. Onder Geautoriseerde JavaScript-oorsprongen:
    • Voor de VS, Centraal-Amerika en Zuid-Amerika, ga naar https://h.app.wdesk.com.
    • Voor APAC, voer https://h.apac.wdesk.com. in.
    • Voor Canada, ga naar https://h.ca.wdesk.com.
    • Voor EMEA, ga naar https://h.eu.wdesk.com.
  12. Onder Geautoriseerde omleidings-URI's:
    • Voor de VS, Centraal-Amerika en Zuid-Amerika, voer https://h.app.wdesk.com/s/wdata/oc/app/oauth/callbackin.
    • Voor APAC, voer https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback. in.
    • Voor Canada, voer https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback. in.
    • Voor EMEA, voer https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback. in.
  13. Klik op Aanmakenen noteer de client-ID en het geheim.

Configureer de Google Cloud Storage-connector met de standaard inloggegevens van de toepassing.

  1. Klik in Chain Builderop compare_arrows Connections in de linkerzijbalk en vervolgens op Createcompare_arrows rechtsboven.
  2. Selecteer onder Connectorverbindingde optie Google Cloud Storage en de runner die u met de connector wilt gebruiken.
    google-cloud-storage_01.png
  3. Voer onder Basisinfoeen unieke naam en beschrijving in om de connector te identificeren.
  4. Selecteer bij Authenticatietypede optie Standaard.

  5. Om te authenticeren met het inloggegevensbestand van de applicatie:

    • Upload onder Resourceshet inloggegevensbestand voor de Google-webtoepassing van de connector.
    • Onder Authenticatievoer je de naam van het inloggegevensbestand in, bijvoorbeeld application_default_credentials.json.
    Opmerking: Om te authenticeren met een standaard serviceaccount, laat u Resources en Authentication leeg.
  6. Voer onder Eigenschappende standaard Cloud Storage-bucket in die met de connector moet worden gebruikt als deze niet door een opdracht is opgegeven.
  7. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
  8. Om de verbinding te testen, maak en voer een keten uit met het commandoList Objects van de connector en controleer of deze een geldige uitvoer retourneert.

Stel de Google Cloud Storage-connector in met OAuth-toestemming.

  1. Klik in Chain Builderop compare_arrows Connections in de linkerzijbalk en vervolgens op Createcompare_arrows rechtsboven.
  2. Selecteer onder Connector Connectionde optie Google Cloud Storage en de standaard CloudRunner.
    google-cloud-storage_02.png
  3. Voer onder Basisinfoeen unieke naam en beschrijving in om de connector te identificeren.
  4. Selecteer bij Authenticatietypede optie OAuth 2.0.

  5. Voer onder OAuthde client-ID en het clientgeheim in voor de Google-webtoepassing van de connector.

    Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met behulp van de Advanced Encryption Standard (AES)-256-codering.

  6. Klik op Verbindenen geef de connector toegang tot uw Google-account.

    Opmerking: Om ervoor te zorgen dat Google de toegang van de connector kan autoriseren, moet u pop-ups in uw browser inschakelen.
  7. Voer onder Eigenschappende standaard Cloud Storage-bucket in die met de connector moet worden gebruikt als deze niet door een opdracht is opgegeven.
  8. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
  9. Om de verbinding te testen, maak en voer een keten uit met het commando List Objects van de connector en controleer of deze een geldige uitvoer retourneert.

Probleemoplossing

Als de verbinding met Google Cloud Storage mislukt:

  • Controleer het inloggegevensbestand of de OAuth-gegevens van de Google-webapplicatie.
  • Controleer de geautoriseerde JavaScript-bron van de applicatie:
    • Voor de VS, Centraal-Amerika en Zuid-Amerika, https://h.app.wdesk.com.
    • Voor APAC, https://h.apac.wdesk.com.
    • Voor Canada, https://h.ca.wdesk.com.
    • Voor EMEA, https://h.eu.wdesk.com.
  • Zorg ervoor dat de omleidings-URI van de applicatie correct is:
    • Voor de VS, Centraal-Amerika en Zuid-Amerika, https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback.
    • Voor APAC, https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback.
    • Voor Canada, https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback.
    • Voor EMEA, https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback.
  • Controleer of de webapplicatie toegang heeft tot de Google Cloud Storage API.
Met de Google® Cloud Storage-connector kunt u opdrachten in een keten gebruiken om bestanden en mappen in Google Clou...