Miro-Konnektoren für Okta-Workflows ermöglichen es dir, sich wiederholende und mehrstufige Verwaltungsaufgaben in Miro einfach zu automatisieren. Erfahre, wie du die Workflow-Automatisierung einrichten und die Team- und Nutzerverwaltung vereinfachen kannst.
Relevant für: Enterprise-Preisplan
Miro-Nutzermanagement-Konnektor
Der Miro-Nutzermanagement-Konnektor ermöglicht Miro-Enterprise-Kunden mit aktiviertem SCIM, Nutzer zu ihrer Organisation hinzuzufügen und die Lizenzen und den Status der Nutzer zu verwalten.
Autorisiere deinen Miro-Nutzermanagement-Konnektor:
Wenn du zum ersten Mal eine Miro-Nutzermanagement-Karte zu einem Flow hinzufügst, wirst du aufgefordert, eine Verbindung für deine Organisation einzurichten. Siehe Autorisierung.
Miro-Nutzermanagement-Konnektor-Aktionskarten:
Aktion |
Beschreibung |
Nutzer erstellen |
Erstellt einen neuen Nutzer. |
Nutzer lesen |
Suche per E-Mail-Adresse nach einem Nutzer in einer Organisation. |
Upgrade des Nutzerlizenztyps auf Vollmitglied |
Aktualisiert eine vorhandene Nutzerressource und ändert ihren Nutzerlizenztyp auf Vollmitglied. |
Aktualisieren des Nutzerstatus |
Aktualisiert eine bestehende Nutzerressource und ändert ihren aktiven Status auf den Wert „true“ oder „false“.Der Miro-Nutzermanagement-Konnektor funktioniert mit deinem SCIM-Token. Das Miro-Nutzermanagement ist nur für Unternehmen mit aktiviertem SSO und SCIM verfügbar. |
Autorisierung
Auf der Seite Verbindungen kannst du mehrere Verbindungen erstellen und verwalten.
Dies ist nützlich, wenn du planst, mit mehreren Organisationen zusammenzuarbeiten. Jede Verbindung für den Miro-Nutzermanagement-Konnektor kann sich nur auf eine Miro-Organisation beziehen.
Um SCIM zu aktivieren und ein neues Token zu erhalten oder ein vorhandenes Token zu kopieren, musst du die Anweisungen unter So aktivierst du SCIM befolgen.
Erstellen einer neuen Verbindung von einer Aktionskarte:
- Klicke auf Neue Verbindung.
- Gib einen Verbindungsnamen ein. Wir empfehlen einen Namen, der die Organisation repräsentiert.
-
Aktiviere die SCIM-Bereitstellung auf der Enterprise-Integrationsseite von Miro, indem du den Anweisungen folgst.
- Kopiere die Basis-URL aus Miro füge sie in das Feld Basis-URL in der Verbindung ein.
- Kopiere das Api-Token aus Miro und füge es in der Verbindung in das Feld Zugriffs-Token ein.
- Klicke auf Erstellen. Damit speicherst du deine Verbindung und gelangst zu deinem Flow zurück.
Nutzer erstellen
Erstellt einen Nutzer in der Organisation.
Eingabe
Feld | Definition | Typ | Erforderlich |
Nutzerdetails | |||
E-Mail-Adresse | Die E-Mail-Adresse der des Nutzers. | String | WAHR |
Aktiv |
Der Status der des Nutzers.
|
Dropdown | FALSCH |
Nutzerlizenztyp |
Der Lizenztyp der des Nutzers.
|
Dropdown | FALSCH |
Rolle |
Die Rolle der des Nutzers in der Organisation.
|
Dropdown | FALSCH |
Name | |||
Familienname | Der Familienname oder Nachname der des Nutzers. | String | FALSCH |
Vorname | Der Vorname der des Nutzers. | String | FALSCH |
Anzeigename |
Der Name, der in Miro angezeigt wird. |
String |
FALSCH |
Ausgabe
Feld |
Definition |
Typ |
Nutzer | ||
Nutzer-ID | Die ID der neuen Person. | String |
Nutzer lesen
Suche per E-Mail-Adresse nach einem Nutzer in einer Organisation
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Abfrage |
|
||
E-Mail-Adresse |
Die E-Mail-Adresse des zu suchenden Nutzers |
String |
WAHR |
Ausgabe
Feld |
Definition |
Typ |
Nutzer | ||
Nutzer-ID |
Die ID des Nutzers. |
Nummer |
Nutzerlizenztyp |
Der Lizenztyp des Nutzers. |
Nummer |
Aktiv |
Der Status des Nutzers.
|
Nummer |
Name |
|
|
Nutzername |
Die E-Mail-Adresse des Nutzers. |
Nummer |
Familienname |
Der Familienname oder Nachname des Nutzers. |
Nummer |
Vorname |
Der Vorname des Nutzers. |
Nummer |
Anzeigename |
Der in Miro angezeigte Name. |
Nummer |
Upgrade des Nutzerlizenztyps auf Vollversion
Aktualisiert eine vorhandene Nutzerressource und ändert ihren Nutzertyp (Lizenz) auf Vollmitglied.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Nutzer |
|
||
Nutzer-ID |
Die ID des Nutzers. |
String |
WAHR |
Ausgabe
Feld |
Definition |
Typ |
Antwort |
||
Statuscode |
HTTP-Status der Anfrage.
Codes, die eine nicht erfolgreiche Lizenzaktualisierung anzeigen:
|
Nummer |
Nutzerstatus aktualisieren
Aktualisiert eine vorhandene Nutzerressource und ändert ihren aktiven Status in den Wert „wahr“ oder „falsch“.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Nutzer |
|
|
|
Nutzer-ID |
Die ID des Nutzers. |
String |
WAHR |
Aktiv |
Der neue Status des Nutzers.
|
Dropdown |
WAHR |
Ausgabe
Feld |
Definition |
Typ |
Antwort |
||
Statuscode |
HTTP-Status der Anfrage.
Codes, die eine nicht erfolgreiche, aktive Statusaktualisierung anzeigen:
|
Nummer |
Miro-Administrations-Konnektor
Der Miro-Administrations-Konnektor ermöglicht Enterprise-Kunden, Teams zu erstellen und ihre Teameinstellungen und -mitglieder zu verwalten.
Autorisiere deinen Miro-Administrations-Konnektor:
Wenn du zum ersten Mal eine Miro-Karte zu einem Flow hinzufügst, wirst du aufgefordert, eine Verbindung für deine Organisation einzurichten. Siehe Autorisierung.
Miro-Administrations-Konnektor-Aktionskarten:
Aktion |
Beschreibung |
Team erstellen |
Erstellt in einer bestehenden Organisation ein neues Team. |
Teams suchen |
Suche nach bestehenden Teams in einer Organisation. Die ersten zehn übereinstimmenden Datensätze werden aus dem Ergebnissatz ausgewählt. |
Mitglied zum Team hinzufügen |
Fügt einem bestehenden Team ein neues Mitglied hinzu. |
Teammitgliedsrolle aktualisieren |
Aktualisiert eine Teammitgliedsrolle in einem bestehenden Team. |
Teameinstellungen abrufen |
Ruft die Teameinstellungen eines bestehenden Teams ab. |
Einstellungen der Team-Freigaberichtlinien aktualisieren |
Aktualisiert die Einstellungen für die Freigaberichtlinien eines bestehenden Teams. |
Team-Einladungseinstellungen aktualisieren |
Aktualisiert die Einstellungen für die Einladungsrichtlinie eines bestehenden Teams. |
Team-Zusammenarbeitseinstellungen aktualisieren |
Aktualisiert die Einstellungen für die Zusammenarbeitsrichtlinien eines bestehenden Teams. |
Einstellungen zum Finden von Teams aktualisieren |
Aktualisiert die Einstellungen für die Richtlinie zum Finden eines bestehenden Teams. |
Einstellungen für die Berechtigungsstufe zum Kopieren innerhalb eines Teams aktualisieren |
Aktualisiert die Einstellungen für die Kopierzugriffsrichtlinie eines bestehenden Teams. |
Löschung der Nutzersitzung (Beta) |
Löscht alle Sitzungen für eine bestimmte E-Mail-Adresse. |
Autorisierung
Der Miro-Administrations-Konnektor arbeitet mit dem OAuth-API-Token. Der Miro-Administrations-Konnektor ist nur für Kunden mit Enterprises-Preisplan verfügbar. Zum Erstellen einer neuen Verbindung musst du die erforderlichen Berechtigungen haben, um Apps mit den unten aufgeführten unterstützten Bereichen zu installieren.
Auf der Seite Verbindungen kannst du mehrere Verbindungen erstellen und verwalten.
Dies ist nützlich, wenn du planst, mit mehreren Organisationen zusammenzuarbeiten. Jede Verbindung für den Miro-Administrations-Konnektor kann sich nur auf eine Miro-Organisation beziehen.
Erstellen einer neuen Verbindung von einer Aktionskarte:
- Klicke auf Neue Verbindung.
- Gib einen Verbindungsnamen ein. Wir empfehlen einen Namen, der die Organisation repräsentiert.
- Hole dir die Organisations-ID und das Zugriffs-Token von der Enterprise-Integrationsseite von Miro gemäß den Anweisungen.
- Klicke auf Erstellen. Damit speicherst du deine Verbindung und gelangst zu deinem Flow zurück.
Unterstützte Bereiche:
- organizations:teams:write
- organizations:teams:read
Erstellen eines Teams
Erstellt ein Team in einer bestehenden Organisation.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Teamname |
Der Name des Teams. |
String |
WAHR |
Ausgabe
Feld |
Definition |
Typ |
Antwort |
|
|
Team-ID |
Die ID des neuen Teams. |
String |
Teams suchen
Suche nach bestehenden Teams in einer Organisation. Die ersten zehn übereinstimmenden Datensätze werden aus dem Ergebnissatz ausgewählt.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Abfrage |
|
|
|
Teamname |
Wörter, die mit dem Teamnamen übereinstimmen. Jedes Team, dessen Name genau diese Wörter enthält, werden als Ergebnissatz zurückgegeben. Teams mit Namen, die vollständig mit der Abfrage übereinstimmen, werden im Ergebnis ganz oben stehen. |
String |
FALSCH |
Ausgabe
Feld |
Definition |
Typ |
Antwort |
|
|
Teams |
Liste mit zehn ersten Teams gefunden. Jedes Team hat die folgenden Felder. |
Liste |
Team-ID |
Die ID des Teams | String |
Name |
Name des Teams | String |
Mitglied zum Team hinzufügen
Fügt einem bestehenden Team ein neues Mitglied hinzu.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Team-ID |
Die ID des Teams. |
String |
WAHR |
Mitglied |
|
|
|
Nutzer-E-Mail-Adresse |
Die E-Mail-Adresse des Nutzers, die du zum Team hinzufügen möchtest. |
String |
WAHR |
Ausgabe
Feld |
Definition |
Typ |
Antwort |
|
|
Mitglieds-ID |
Die ID des neuen Teammitglieds. |
String |
Teammitgliedsrolle aktualisieren
Aktualisiert eine Teammitgliedsrolle in einem bestehenden Team.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Team-ID |
Die ID des Teams. |
String |
WAHR |
Mitglied |
|
|
|
Mitglieds-ID |
Die ID des Teammitglieds. |
String |
WAHR |
Rolle |
Die neue Rolle des Mitglieds im Team.
|
Dropdown |
WAHR |
Ausgabe
Feld |
Definition |
Typ |
Antwort |
|
|
Mitglieds-ID |
Die ID des Teammitglieds. |
String |
Rolle |
Die neue Rolle, die dem Teammitglied zugewiesen ist.
|
String |
Teameinstellungen abrufen
Ruft die Teameinstellungen eines bestehenden Teams ab.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Team-ID |
Die ID des Teams. |
String |
WAHR |
Ausgabe
Feld |
Definition |
Typ |
Team-Einladungseinstellungen |
||
Wer einladen kann |
|
String |
Externe Nutzer einladen |
|
String |
Team-Zusammenarbeitseinstellungen |
||
Miteigentümerrolle |
|
String |
Einstellungen für die Berechtigungsstufe zum Kopieren innerhalb eines Teams |
||
Kopierberechtigungsstufe |
|
String |
Kopierberechtigungsstufe – Einschränkungen |
|
String |
Einstellungen zum Finden von Teams |
|
|
Finden |
|
String |
Einstellungen der Team-Freigaberichtlinien |
||
Standard-Board-Zugriff |
|
String |
Standard-Organisationszugriff |
|
String |
Freigabe in der Organisation
|
|
String |
Freigabe im Team |
|
String |
Freigabe über öffentlichen Link |
|
String |
Board zum Team verschieben |
|
String |
Einstellungen der Team-Freigaberichtlinien aktualisieren
Aktualisiert die Einstellungen für die Freigaberichtlinien eines bestehenden Teams.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Team-ID |
Die ID des Teams. |
String |
WAHR |
Standard-Board-Zugriff |
|
Dropdown |
FALSCH |
Standard-Organisations-Zugriff |
|
Dropdown |
FALSCH |
Freigabe über öffentlichen Link |
|
Dropdown |
FALSCH |
Freigabe im Team |
|
Dropdown |
FALSCH |
Freigabe in der Organisation
|
|
Dropdown |
FALSCH |
Board zum Team verschieben |
|
Dropdown |
FALSCH |
Ausgabe
Feld |
Definition |
Typ |
Einstellungen der Team-Freigaberichtlinien |
|
|
Standard-Board-Zugriff |
|
String |
Standard-Organisations-Zugriff |
|
String |
Freigabe in der Organisation
|
|
String |
Freigabe im Team |
|
String |
Freigabe über öffentlichen Link |
|
String |
Board zum Team verschieben |
|
String |
Team-Einladungseinstellungen aktualisieren
Aktualisiert die Einstellungen für die Einladungsrichtlinie eines bestehenden Teams.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Team-ID |
Die ID des Teams. |
String |
WAHR |
Externe Nutzer einladen |
|
Dropdown |
FALSCH |
Wer einladen kann |
|
Dropdown |
FALSCH |
Ausgabe
Feld |
Definition |
Typ |
Team-Einladungseinstellungen |
|
|
Externe Nutzer einladen |
|
String |
Wer einladen kann |
|
String |
Einstellungen für die Berechtigungsstufe zum Kopieren innerhalb eines Teams aktualisieren
Aktualisiert die Einstellungen für die Kopierzugriffsrichtlinie eines bestehenden Teams.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Team-ID |
Die ID des Teams. |
String |
WAHR |
Kopierberechtigungsstufe – Einschränkungen |
|
Dropdown |
FALSCH |
Kopierberechtigungsstufe – Einschränkungen |
|
Dropdown |
FALSCH |
Ausgabe
Feld |
Definition |
Typ |
Einstellungen für die Berechtigungsstufe zum Kopieren innerhalb eines Teams |
|
|
Kopierberechtigungsstufe |
|
String |
Kopierberechtigungsstufe – Einschränkungen |
|
String |
Team-Zusammenarbeitseinstellungen aktualisieren
Aktualisiert die Einstellungen für die Zusammenarbeitsrichtlinien eines bestehenden Teams.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Team-ID |
Die ID des Teams. |
String |
WAHR |
Rolle des Miteigentümers |
|
Dropdown |
FALSCH |
Ausgabe
Feld |
Definition |
Typ |
Team-Zusammenarbeitseinstellungen aktualisieren |
|
|
Miteigentümerrolle |
|
String |
Einstellungen zum Finden von Teams aktualisieren
Aktualisiert die Einstellungen für die Richtlinie zum Finden eines bestehenden Teams.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Team |
|
|
|
Team-ID |
Die ID des Teams. |
String |
WAHR |
Finden |
|
Dropdown |
FALSCH |
Ausgabe
Feld |
Definition |
Typ |
Einstellungen zum Finden von Teams |
|
|
Finden |
|
String |
Löschung der Nutzersitzung
Löscht alle Sitzungen für eine bestimmte E-Mail-Adresse.
💡 Wenn deine Enterprise-Organisation am Hinzufügen dieses Konnektors interessiert ist, registriere dich für diese private Beta-Version unserer API: Löschung der Nutzersitzung.
Eingabe
Feld |
Definition |
Typ |
Erforderlich |
Nutzerdetails |
|
|
|
E-Mail-Adresse |
Die E-Mail-Adresse des Nutzers, deren Sitzungen gelöscht werden sollen. |
String |
WAHR |
Ausgabe
Feld |
Definition |
Typ |
Antwort |
||
Statuscode |
HTTP-Status der Anfrage.
Codes, die eine fehlgeschlagene Aktualisierung der Nutzersitzung anzeigen:
|
Nummer |