Miro-Konnektoren für Okta-Workflows ermöglichen es dir, sich wiederholende und mehrstufige Admin-Aufgaben 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 Enterprise-Kunden mit aktiviertem SCIM, Nutzer zu ihrer Organisation hinzuzufügen und deren Lizenzen und Status 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 nach einem bestehenden Nutzer in einer Organisation per E-Mail. |
| Nutzerlizenztyp auf Vollmitglied umstellen | Aktualisiert eine vorhandene Nutzerressource und ändert ihren Nutzerlizenztyp auf Vollmitglied. |
| Nutzerstatus aktualisieren | Aktualisiert eine vorhandene Nutzerressource und ändert ihren aktiven Status in den Wert „wahr“ oder „falsch“.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
Du kannst auf der Seite „Verbindungen“ mehrere Verbindungen erstellen und verwalten.
Das ist nützlich, wenn du vorhast, mit mehreren Organisationen zu arbeiten. 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, befolge die Anweisungen in So aktivierst du SCIM.
Erstellen einer neuen Verbindung von einer Aktionskarte:
- Klicke auf Neue Verbindung.
- Gib einen Verbindungsnamen. Wir empfehlen einen Namen, der die Organisation repräsentiert.
-
Aktiviere die SCIM-Bereitstellung auf der Enterprise-Integrationsseite von Miro, indem du den Anweisungen.
- Kopiere Basis-URL aus Miro und füge sie in das Feld Basis-URL in der Verbindung ein
- Kopiere das Api-Token aus Miro und füge es in das Feld Zugriffs-Token in der Verbindung ein
- Klicke auf Erstellen. Damit speicherst du deine Verbindung und gelangst zu deinen Flows zurück.
Nutzer erstellen
Erstellt einen Nutzer in der Organisation.
Eingabe
| Feld | Definition | Typ | Erforderlich |
| Nutzerdetails | |||
| E-Mail-Adresse | Die E-Mail-Adresse des Nutzers. | String | TRUE |
| Aktiv |
Der Status des Nutzers.
Wenn nicht angegeben, lautet die Standardeinstellung falsch. |
Dropdown | FALSE |
| Nutzerlizenztyp |
Der Lizenztyp des Nutzers.
Wenn nicht angegeben, wird die Nutzerlizenz gemäß der internen Miro-Logik festgelegt, die vom Preisplan der Organisation abhängt. |
Dropdown | FALSCH |
| Rolle |
Die Rolle des Nutzers in der Organisation.
Wenn nicht angegeben, lautet die Standardeinstellung Organisationsmitglied. |
Dropdown | FALSE |
| Name | |||
| Familienname | Der Familienname oder Nachname des Nutzers. | String | FALSCH |
| Vorname | Der Vorname des Nutzers. | String | FALSCH |
| Anzeigename | Der Name, der in Miro angezeigt wird. | String | FALSCH |
Ausgabe
| Feld | Definition | Typ |
| Nutzer | ||
| Nutzer-ID | Die ID des neuen Nutzers. | String |
Nutzer lesen
Suche nach einem bestehenden Nutzer in einer Organisation per E-Mail
Eingabe
| Feld | Definition | Typ | Erforderlich |
| Abfrage | |||
| E-Mail-Adresse | Die E-Mail-Adresse des zu suchenden Nutzers | String | TRUE |
Ausgabe
| Feld | Definition | Typ |
| Nutzer | ||
| Nutzer-ID | Die ID des Nutzers. | Zahl |
| Lizenztyp des Nutzers | Der Lizenztyp des Nutzers. | Zahl |
| Aktiv |
Der Status des Nutzers.
|
Nummer |
| Name | ||
| Benutzername | Die E-Mail-Adresse des Nutzers. | Zahl |
| Familienname | Der Familienname oder Nachname des Nutzers. | Nummer |
| Vorname | Der Vorname des Nutzers. | Nummer |
| Angezeigter Name | Der in Miro angezeigte Name. | Nummer |
Upgrade des Nutzerlizenztyps auf Vollmitglied
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 | TRUE |
| Aktiv |
Der neue Status des Nutzers.
|
Dropdown | WAHR |
Ausgabe
| Feld | Definition | Typ |
| Antwort | ||
| Statuscode |
HTTP-Status der Anfrage.
Codes, die eine nicht erfolgreiche Aktualisierung des aktiven Status anzeigen:
|
Nummer |
Miro-Administrations-Konnektor
Der Miro-Administrations-Konnektor ermöglicht Enterprise-Kunden, Teams zu erstellen und ihre Teameinstellungen und -mitglieder zu verwalten.
Autorisieren deines Miro-Administrations-Konnektors:
Wenn du zum ersten Mal eine Miro-Karte zu einem Flow hinzufügst, wirst du aufgefordert, eine Verbindung für deine Organisation einzurichten. Sieh dir 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 die Rolle eines Teammitglieds 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. |
| Team-Kopierzugriffseinstellungen aktualisieren | Aktualisiert die Einstellungen für die Kopierzugriffsrichtlinie eines bestehenden Teams. |
| Nutzer-Sitzungen löschen (Betaversion) | Löscht alle Sitzungen für eine angegebene E-Mail-Adresse. |
Autorisierung
Der Miro-Administrations-Konnektor arbeitet mit dem OAuth-API-Token. Der Miro-Administrations-Konnektor ist nur für Kunden mit Enterprise-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.
Du kannst mehrere Verbindungen auf der „Verbindungen“-Seite erstellen und verwalten.
Das ist nützlich, wenn du mit mehreren Organisationen arbeiten möchtest. Jede Verbindung für den Miro-Administrations-Konnektor kann nur auf eine Miro-Organisation verweisen.
So stellst du über eine Aktionskarte eine neue Verbindung her:
- Klicke auf Neue Verbindung.
- Gib einen Verbindungsnamen. Wir empfehlen einen Namen, der die Organisation repräsentiert.
- Rufe Organization ID und Access Token von der Enterprise-Integrationsseite von Miro ab, indem du den Anweisungen folgst.
- Klicke auf Erstellen. Damit speicherst du deine Verbindung und gelangst zu deinem Flow zurück.
Unterstützte Bereiche:
- organizations:teams:write
- organizations:teams:read
Team erstellen
Erstellt ein Team in einer bestehenden Organisation.
Eingabe
| Feld | Definition | Typ | Erforderlich |
| Team | |||
| Teamname | 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, wird 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 der ersten 10 gefundenen Teams. 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 | TRUE |
| Mitglied | |||
| E-Mail-Adresse des Nutzers | Die E-Mail-Adresse des Nutzers, den du in das Team aufnehmen möchtest. | String | TRUE |
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 | TRUE |
| Mitglied | |||
| Mitglieds-ID | Die ID des Teammitglieds. | String | TRUE |
| 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 |
| Einstellungen zur Einladung ins Team | ||
| Wer einladen kann |
|
String |
| Externe Nutzer einladen |
|
String |
| Team-Zusammenarbeitseinstellungen | ||
| Miteigentümer-Rolle |
|
String |
| Einstellungen für Kopierzugriff auf Teamebene | ||
| Kopierberechtigungsstufe |
|
String |
| Kopierberechtigungsstufe Einschränkung |
|
String |
| Team Discovery-Einstellungen | ||
| Auffindbarkeit |
|
String |
| Einstellungen der Team-Freigaberichtlinien | ||
| Standard-Board-Zugriff |
|
String |
| Standard-Organisationszugriff |
|
String |
|
Freigabe auf Organisationsebene
|
|
String |
| Freigabe auf Teamebene |
|
String |
| Freigabe über öffentlichen Link |
|
String |
| Board in ein anderes 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 | TRUE |
| Standard-Board Zugriff |
|
Dropdown | FALSCH |
| Standard Organisationszugriff |
|
Dropdown | FALSCH |
| Freigabe über öffentlichen Link |
|
Dropdown | FALSCH |
| Freigabe im Team |
|
Dropdown | FALSCH |
|
Freigabe in der Organisation
|
|
Dropdown | FALSCH |
| Board in Team verschieben |
|
Dropdown | FALSCH |
Ausgabe
| Feld | Definition | Typ |
| Einstellungen der Team-Freigaberichtlinien | ||
| Standard-Board-Zugriff |
|
String |
| Standard-Organisationszugriff |
|
String |
|
Freigabe auf Organisationsebene
|
|
String |
| Freigabe im Team |
|
String |
| Freigabe über öffentlichen Link |
|
String |
| Board in ein anderes 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 | TRUE |
| Externe Nutzer einladen |
|
Dropdown | FALSCH |
| Wer kann einladen |
|
Dropdown | FALSCH |
Ausgabe
| Feld | Definition | Typ |
| Einstellungen für Teameinladungen | ||
| Externe Nutzer einladen |
|
Zeichenfolge |
| Wer kann einladen |
|
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 | TRUE |
| Kopierberechtigungsstufe |
|
Dropdown | FALSCH |
| Kopierberechtigung 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 |
| Miteigentümer Rolle |
|
Dropdown | FALSCH |
Ausgabe
| Feld | Definition | Typ |
| Team-Zusammenarbeitseinstellungen | ||
| Miteigentümer-Rolle |
|
String |
Einstellungen zum Finden von Teams aktualisieren
Aktualisiert die Einstellungen der Discovery-Richtlinie für ein bestehendes Team.
Eingabe
| Feld | Definition | Typ | Erforderlich |
| Team | |||
| Team-ID | Die ID des Teams. | String | TRUE |
| Auffindbarkeit |
|
Dropdown | FALSCH |
Ausgabe
| Feld | Definition | Typ |
| Team-Discovery-Einstellungen | ||
| Auffindbarkeit |
|
String |
Löschung der Nutzersitzung
Löscht alle Sitzungen für eine bestimmte E-Mail-Adresse.
Eingabe
| Feld | Definition | Typ | Erforderlich |
| Nutzerdetails | |||
| E-Mail-Adresse | Die E-Mail-Adresse des Nutzers, dessen Sitzungen gelöscht werden sollen. | String | TRUE |
Ausgabe
| Feld | Definition | Typ |
| Antwort | ||
| Statuscode |
HTTP-Status der Anfrage.
Codes, die eine fehlgeschlagene Aktualisierung der Nutzersitzung anzeigen:
|
Nummer |