Dieser Leitfaden führt einen Salesforce-Administrator durch die Einrichtung der Bliro ⭤ Salesforce Integration: Installiere das Bliro-Paket einmalig in deiner Salesforce-Organisation, verbinde die Organisation mit wenigen Klicks mit Bliro - danach verbindet jeder Bliro-Nutzer in deinem Unternehmen sein eigenes Salesforce-Konto und erteilt individuell die Zugriffsberechtigung. Du musst keine Nutzer-Zugangsdaten verwalten.
Bevor du anfängst
Du bist Salesforce-Administrator mit der Berechtigung, Pakete zu installieren
(Download AppExchange Packages / Customize Application).Deine Organisation hat My Domain eingerichtet (alle modernen Organisationen haben das) und unterstützt installierte Pakete sowie API-Zugriff (Enterprise, Unlimited, Developer oder Professional mit API-Zugriff).
Jeder Nutzer, der die Integration verwenden wird, hat die Berechtigung
API Enabled(in seinem Profil oder über ein Permission Set).Du bist auch
Bliro-Adminund bei app.bliro.io angemeldet.
🔒 Die Einrichtung von Bliro erstellt und verändert nichts in deiner Salesforce -Organisation. Bliros App-Einstellungen werden von Bliro verwaltet und über Salesforces Standardmechanismus für gepackte Apps verteilt. Der einzige Wert, der mit Bliro geteilt wird, ist eine öffentliche Client-ID.
Schritt 1: Das Bliro-Paket installieren (Salesforce)
Öffne in Bliro Einstellungen → Integrationen → + → Salesforce → Einrichten und klicke auf Bliro in Salesforce installieren. (Um zuerst in einer Sandbox zu installieren, nutze den Link "Stattdessen in einer Sandbox installieren".)
Melde dich mit einem Administratorkonto bei der Salesforce-Organisation an, in der du Bliro installieren möchtest.
Wähle auf dem Installationsbildschirm "Nur für Admins installieren" (empfohlen, da normale Nutzer die Setup-Komponenten nicht benötigen) und klicke auf Installieren.
Wenn Salesforce Zugriff auf Drittanbieter-Websites genehmigen anzeigt, setze den Haken bei Ja, diesen Drittanbieter-Websites Zugriff gewähren und klicke auf Weiter.
Warte auf die Meldung Installation abgeschlossen. Du kannst die Installation unter Setup → Installierte Pakete → Bliro überprüfen.
Schritt 2: Deine Organisation mit Bliro verbinden
Öffne in Salesforce den App Launcher (Raster-Symbol), suche nach Bliro Setup und öffne es. Die Seite zeigt an, dass deine Organisation bereit ist, zusammen mit der öffentlichen Client-ID der App und der Domain deiner Organisation.
Klicke auf Setup in Bliro abschließen. Bliro öffnet sich, registriert deine Salesforce-Organisation automatisch im Hintergrund, zeigt eine Bestätigung an und leitet dich direkt zur Salesforce-Integrationsseite weiter.
Das ist die gesamte Einrichtung auf Organisationsebene. Insgesamt etwa 3 Minuten.
Schritt 3: Dein eigenes Salesforce-Konto verbinden
Klicke auf der Salesforce-Integrationsseite, auf der du gerade gelandet bist, auf Verbinden. Stelle sicher, dass dein Browser keine Pop-ups blockiert.
Melde dich bei Salesforce an, wenn du dazu aufgefordert wirst, überprüfe die angeforderten Berechtigungen und klicke auf Erlauben.
Du wirst zu Bliro zurückgeleitet, wo die Integration als Verbunden angezeigt wird.
Schritt 4: Dein Team verbindet sich (Self-Service)
Jeder Bliro-Nutzer öffnet Bliro → Einstellungen → Integrationen → Salesforce → Verbinden, meldet sich bei Salesforce an und bestätigt den Einwilligungsbildschirm. Von da an agiert Bliro ausschließlich als dieser Nutzer und respektiert dessen Profil, Permission Sets, Freigaberegeln und Field-Level Security. Nutzer, die nicht zugestimmt haben, können nicht vertreten werden.
Kontrolle behalten (Admin-Referenz)
In Salesforce (Setup → External Client App Manager → Bliro → Richtlinien): aktualisiere zugelassene Nutzer auf genehmigte Profile/Permission Sets, verwalte die Lebensdauer des Refresh-Tokens oder deaktiviere die App mit einem Klick. Es ist auch möglich, einen einzelnen Nutzer unter Connected Apps OAuth Usage zu widerrufen.
In Bliro (Integrationsseite → ⋮ Menü): lege die Instanz als Organisationsstandard fest oder lösche die Integration für die gesamte Organisation (trennt die Verbindung für alle Mitglieder).
Das Deinstallieren des Pakets (Salesforce → Setup → Installierte Pakete) macht alle Tokens sofort ungültig.
Fehlerbehebung
Problem | Was zu tun ist |
| Salesforce verteilt die App-Konfiguration mit einer kurzen Verzögerung nach der Installation. Warte einige Minuten und versuche es erneut. Falls das Problem weiterhin besteht, stelle sicher, dass das Paket in derselben Organisation installiert ist, bei der du dich anmeldest. |
Die Bliro Setup-Seite meldet, dass die App nicht gefunden wurde | Das Paket ist in dieser Organisation noch nicht installiert - schließe Schritt 1 ab und lade die Seite neu. |
Der Verbinden-Button eines Teammitglieds ist deaktiviert | Die Organisationseinrichtung (Schritt 2) wurde noch nicht abgeschlossen, oder der Nutzer ist nicht durch die Permitted Users-Richtlinie der App in Salesforce zugelassen. |
Das Salesforce-Pop-up erscheint nicht | Erlaube Pop-ups für |
"Insufficient privileges" während der Installation | Dein Salesforce-Nutzer kann keine Pakete installieren. Bitte einen Salesforce-Administrator, Schritt 1 abzuschließen. |
Verbunden, aber Bliro kann einen Datensatz nicht lesen oder schreiben | Bliro agiert als der angemeldete Nutzer. Überprüfe das Profil, die Permission Sets und die Field-Level Security dieses Nutzers in Salesforce. |
Sicherheit & Berechtigungen
Kein Fußabdruck: In deiner Salesforce-Organisation wird nichts erstellt oder verändert; die Setup-Seite ist schreibgeschützt.
Keine Geheimnisse: Bliro authentifiziert sich mit dem OAuth 2.0 Authorization-Code-Flow mit PKCE (erforderlich). Ein Consumer Secret existiert nirgendwo im Flow. Refresh-Tokens rotieren bei jeder Verwendung und laufen bei Inaktivität ab.
Einwilligung pro Nutzer: Jeder Nutzer genehmigt den Zugriff individuell auf dem Standard-Salesforce-Bildschirm; Bliro ist immer durch die Berechtigungen dieses Nutzers beschränkt.
Für das vollständige Authentifizierungsmodell und die angeforderten OAuth-Scopes siehe Salesforce Integration: Einrichtung und Sicherheitsübersicht.
Brauchst du Hilfe?
Falls du während der Installation oder Verbindung nicht weiterkommst, kontaktiere [email protected].