Workiva supportcenter

Med BlackLine® OAuth2 Connector kan du använda kommandon i en kedja för att interagera med BlackLine, t.ex. för att:

• Lista och ladda ner rapporter från BlackLine
• Importera och hantera data i BlackLine, inklusive:
  • Konton
  • Balanser
  • Valutakurser
  • Subledgers
  • Enheter
  • Uppgifter
  • Användare

Obs: Denna kontakt är byggd av Workiva och ansluts till ett system från tredje part. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.

Förutsättningar

För att sätta upp kontakten behöver du:

• Värdnamnet för den BlackLine-instans som du ska ansluta till, t.ex. sbus2.api.blackline.com
• Användarnamn och API-nyckel för en integrationsanvändare som konfigurerats för ett BlackLine-tjänstekonto

  Notera: Integrationsanvändaren behöver API-auktoriseringsroller och integrationsbehörigheter, samt de roller och scope som krävs för de uppgifter som connectorn ska utföra. För att skapa API-nyckeln i BlackLine klickar du på Generera för API-nyckel under Användarinformation på integrationsanvändarens detaljer.

• Endast Blackline API version 2.0 har support
• Integrationsanvändarens klientuppgifter och OAuth-scopes, som tillhandahålls av ditt BlackLine-integrationsteam

  Obs: Om du behöver klient-ID, klienthemlighet eller scopes, kontakta din BlackLine-representant.

Konfigurera BlackLines OAuth2-koppling

Obs: För att göra kontakten tillgänglig för användning i din organisations kedjor, en org säkerhetsadministratör först aktivera den från Konfiguration.

1. Från Chain Builder, klicka på Connections compare_arrows, och sedan Create längst upp till höger.
2. Under Connector Connection väljer du BlackLine OAuth2 och standard CloudRunner.
   
3. Ange ett unikt namn och en beskrivning som hjälper till att identifiera anslutningen.
4. Under Properties anger du information om anslutningen:
   
   

   Egenskap	Information
   Användarnamn	Ange användarnamnet för BlackLine-integrationsanvändaren.
   Lösenord	Ange den API-nyckel som genererats för BlackLine-integrationsanvändaren. Obs: För att skapa eller uppdatera API-nyckeln i BlackLine klickar du på Generera för API-nyckel under Användarinformation på integrationsanvändarens detaljer. Detta är inte det lösenord som används för att logga in på BlackLine online.
   Klient-ID	Ange det kund-ID som du har fått från ditt BlackLine-integrationsteam.
   Klientens hemlighet	Ange den klienthemlighet som tillhandahålls av ditt BlackLine-integrationsteam.
   Omfattningar	Ange integrationsanvändarens OAuth-scopes, som tillhandahålls av ditt BlackLine-integrationsteam. Anslutningsdonet kommer att använda samma omfång.
   Instansens värdnamn	Ange värdnamnet för den BlackLine-instans som du vill ansluta till, utan https://. För standardutvecklingsmiljön gäller till exempel sbus2.api.blackline.com.

   Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.

5. Välj de miljöer som ska använda anslutningen och klicka på Save.
6. För att testa anslutningen, skapa och kör en kedja med BlackLine OAuth2-konnektorns List Reports-kommando, och verifiera att den returnerar en giltig utdata.

Felsökning

Om anslutningen till BlackLine går sönder:

• Verifiera klientautentiseringsuppgifterna och OAuth-scopes som tillhandahålls av ditt BlackLine-integrationsteam. Om du behöver OAuth-scopes eller klient-ID eller -hemlighet, kontakta din BlackLine-representant.
• Se till att integrationsanvändarens användarnamn och API-nyckel är korrekta.

  Obs: Integrationsanvändarens API-nyckel kan upphöra att gälla. För att uppdatera API-nyckeln i BlackLine klickar du på Generera för API-nyckel under Användarinformation på integrationsanvändarens detaljer.

• Kontrollera att integrationsanvändaren har API-behörighet och rätt roller och scope för att utföra de uppgifter som är relaterade till anslutningens kommandon.
• Kontrollera att rätt värdnamn för BlackLine-instansen anges för anslutningen.