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 Nutzermanagement-Konnektor von Miro ermöglicht unseren 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/span>.
Miro-Nutzermanagement-Konnektor-Aktionskarten:
Aktion | Beschreibung |
Nutzer erstellen | Erstellt einen neuen Nutzer. |
Person lesen | Suche nach einem bestehenden Nutzer in einer Organisation per E-Mail. |
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
Du kannst mehrere Verbindungen erstellen und verwalten, indem du die Verbindungen Seite erstellen und verwalten.
Das ist nützlich, wenn du planst, mit mehreren Organisationen zusammenzuarbeiten. Jede Verbindung für den Miro-Nutzermanagement/span>-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, folgen Sie den Anweisungen unter Wie aktiviere ich SCIM?.
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 des Nutzers. | String | WAHR |
Aktiv |
Der Status des Nutzers.
Wenn nicht angegeben, lautet die Standardeinstellung falsch. |
Dropdown | FALSCH |
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 | FALSCH |
Name | |||
Familienname | Der Familienname oder Nachname der Person. | String | FALSCH |
Vorname | Der Vorname des Nutzers. | String | FALSCH |
Anzeigename | Der Name, der in Miro angezeigt wird. | String | FALSCH |
Ausgabe
Feld | Definition | Typ |
Nutzer | ||
ID des Nutzer | Die ID des neuen Nutzers. | String |
Person 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 | WAHR |
Ausgabe
Feld | Definition | Typ |
Nutzer | ||
ID des Nutzers | Die ID des Nutzer. | Nummer |
Nutzerlizenztyp | Der Lizenztyp des Nutzers. | Nummer |
Aktiv |
Der Status des Nutzers.
|
Nummer |
Name | ||
Name des Nutzers | Die E-Mail-Adresse des Nutzers. | Nummer |
Familienname | Der Familienname oder Nachname der Person. | Nummer |
Vorname | Der Vorname des Nutzers. | Nummer |
Anzeigename | 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 | |||
ID des Nutzers | Die ID des Nutzers. | String | WAHR |
Ausgabe
Feld | Definition | Typ |
Antwort | ||
Statuscode |
HTTP-Status der Anfrage.
Codes, die eine nicht erfolgreiche Lizenzaktualisierung anzeigen:
|
Nummer |
Aktualisieren des Nutzerstatus
Aktualisiert eine vorhandene Nutzerressource und ändert ihren aktiven Status in den Wert „wahr“ oder „falsch“.
Eingabe
Feld | Definition | Typ | Erforderlich |
Nutzer | |||
ID des Nutzers | 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-Admin-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. Siehe Autorisierung/span>.
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 Kundinnen und Kunden mit Enterprises-Preisplan verfügbar. Zum Erstellen einer neuen Verbindung, müssen Nutzer die erforderlichen Berechtigungen haben, um Apps mit den unten aufgeführten unterstützten Bereichen zu installieren.
Du kannst mehrere Verbindungen erstellen und verwalten, indem du die Verbindungen Seite erstellen und verwalten.
Das ist nützlich, wenn du planst, mit mehreren Organisationen zusammenzuarbeiten. Jede Verbindung für den Miro-Administrations-Konnektor kann nur auf eine Miro-Organisation zeigen.
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
Team erstellen
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, den du in das Team aufnehmen 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 | ||
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.
Eingabe
Feld | Definition | Typ | Erforderlich |
Nutzerdetails | |||
E-Mail-Adresse | Die E-Mail-Adresse der Person, 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 |