Met de BlackLine® OAuth2-connector kunt u commando's in een keten gebruiken voor interactie met BlackLine, zoals naar:
- Rapporten weergeven en downloaden van BlackLine
- Importeer en beheer gegevens in BlackLine, inclusief:
- Rekeningen
- Saldi
- Wisselkoersen
- Subgrootboeken
- Entiteiten
- Taken
- Gebruikers
Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.
Vereisten
Om de connector in te stellen, hebt u het volgende nodig:
- De hostnaam van de BlackLine instantie waarmee verbinding moet worden gemaakt, zoals
sbus2.api.blackline.com - De gebruikersnaam en API-sleutel van een integratiegebruiker die is ingesteld voor een BlackLine serviceaccount
Opmerking: De integratiegebruiker heeft API-autorisatierollen en integratiemachtigingen nodig, evenals de rollen en scopes die vereist zijn voor de taken die de connector zal uitvoeren. Om de API-sleutel in BlackLine aan te maken, klikt u op Genereer voor API-sleutel onder Gebruikersinformatie op de details van de integratiegebruiker.
- Alleen Blackline API versie 2.0 wordt ondersteund
- De clientreferenties en OAuth-scopes van de integratiegebruiker, verstrekt door uw BlackLine integratieteam
Opmerking: Neem contact op met uw BlackLine vertegenwoordiger als u de client-ID, het clientgeheim of de scopes nodig hebt.
De BlackLine OAuth2-connector instellen
Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.
- Ga naar Chain Builder, klik op Connections, en vervolgens op Create rechtsboven.
- Selecteer onder Connector Connection BlackLine OAuth2 en de standaard CloudRunner.
- Voer een unieke naam en beschrijving in om de verbinding te helpen identificeren.
- Onder Eigenschappen, voert u de details van de verbinding in:
Eigendom Details Gebruikersnaam Voer de gebruikersnaam van de BlackLine integratiegebruiker in. Wachtwoord Voer de API-sleutel in die is gegenereerd voor de BlackLine integratiegebruiker. Opmerking: Om de API-sleutel in BlackLine aan te maken of te vernieuwen, klikt u op Genereer voor API-sleutel onder Gebruikersinformatie op de details van de integratiegebruiker. Dit is niet het wachtwoord dat gebruikt wordt om u aan te melden bij BlackLine online.
Klant-ID Voer de klant-ID in die u van uw BlackLine integratieteam hebt gekregen. Geheim van de klant Voer het clientgeheim in dat u van uw BlackLine integratieteam hebt gekregen. Scopes Voer de OAuth-scopes van de integratiegebruiker in, verstrekt door uw BlackLine integratieteam. De connector zal dezelfde scopes gebruiken. Instance hostnaam Voer de hostnaam in voor de BlackLine instantie waarmee u verbinding wilt maken, zonder de https://. Bijvoorbeeld, voor de standaard ontwikkelomgeving,sbus2.api.blackline.com.Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.
- Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
- Om de verbinding te testen, creëert en voert u een ketting uit met de opdracht List Reports van de BlackLine OAuth2-connector, en controleert u of deze een geldige uitvoer retourneert.
Probleemoplossing
Als de verbinding met BlackLine mislukt:
- Controleer de clientreferenties en OAuth-scopes die door uw BlackLine integratieteam zijn verstrekt. Als u de OAuth scopes of de client-ID of het geheim nodig hebt, neem dan contact op met uw BlackLine vertegenwoordiger.
- Controleer of de gebruikersnaam en API-sleutel van de integratiegebruiker correct zijn.
Opmerking: De API-sleutel van de integratiegebruiker kan verlopen. Om de API-sleutel in BlackLine te vernieuwen, klikt u op Genereer voor API-sleutel onder Gebruikersinformatie op de details van de integratiegebruiker.
- Controleer of de integratiegebruiker API-autorisatie en de juiste rollen en scopes heeft om de taken met betrekking tot de opdrachten van de verbinding uit te voeren.
- Controleer of de juiste BlackLine instance hostnaam is ingevoerd voor de connector.