Integration mit Miro Enterprise

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 7 Minuten Lesedauer

    • Durch die Integration Ihrer Anwendung Software Asset Management in die Anwendung Miro Enterprise können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.

    Wichtig:
    Minimieren Sie Sicherheitsrisiken und schützen Sie Informationen, indem Sie nur den erforderlichen Anwender- oder API-Berechtigungen Zugriff gewähren.
    Tabelle : 1. Minimale Benutzerberechtigungen
    Prozess Erforderliche Anwenderrolle in der Anwendung Miro Enterprise Authentifizierungsbereiche
    Abonnements herunterladen Unternehmensadministrator Organisationen:lesen
    Rufen Sie die Anwenderaktivität ab Unternehmensadministrator Organisationen:lesen
    Abonnement zurückfordern Unternehmensadministrator Keine

    Erstellen Sie eine Miro Enterprise OAuth 2.0-Anwendung

    Erstellen Sie eine Miro Enterprise OAuth 2.0-Anwendung, um den Zugriff auf die Miro API zu aktivieren.

    Vorbereitungen

    Miro Erforderliche Rolle: Siehe Tabelle „Mindestbenutzerberechtigungen“.

    Prozedur

    1. Öffnen Sie in einem Webbrowser die Miro-Plattform.
    2. Wenn Sie keine Teams in Ihrer Organisation erstellt haben oder die OAuth 2.0-Anwendung mit gefälschten Daten erstellen und testen möchten, rufen Sie ein Entwicklerteam auf.
    3. Wählen Sie im Seiten-Header der Miro -Plattform Ihre Appsaus.
      Die Anmeldeseite wird geöffnet.
    4. Melden Sie sich mit den Anmeldeinformationen Ihres Unternehmensadministrators an.
      Ihr Standard-Organisationsprofil wird geöffnet.
    5. Wählen Sie oben im linken Navigationsbereich das Organisationsprofilsymbol, um die Organisation auszuwählen, für die Sie die OAuth 2.0-Anwendung erstellen möchten.
      Das Profil für die ausgewählte Organisation wird geöffnet.
    6. Wählen Sie im linken Navigationsbereich Profileinstellungenaus.
    7. Wählen Sie in Ihren Profileinstellungen die Registerkarte API, SDK und Einbetten aus.
    8. Aktivieren Sie im Abschnitt „Ihre Apps“ das Kontrollkästchen Ich stimme den Nutzungsbedingungen zu, und wählen Sie dann Neue App erstellen aus.
    9. Füllen Sie die Felder im Dialogfeld aus.
      Tabelle : 2. Dialogfeld „Neue App erstellen“.
      Feld Beschreibung
      App-Name Name der OAuth 2.0-Anwendung.
      Beschreibung Kurze Beschreibung der OAuth 2.0-Anwendung.
    10. Wählen Sie das Team aus, für das Sie die OAuth 2.0-Anwendung erstellen möchten.
    11. Wählen Sie App erstellen.
      Die Einstellungen für Ihre neu erstellte App werden geöffnet.
    12. Kopieren Sie im Abschnitt Your app <app-name > (Ihre App < App-Name>) die Werte in den Feldern Client-ID und Geheimer Clientschlüssel.
      Speichern Sie sie zur späteren Verwendung an einem sicheren Ort.
    13. Geben Sie im Abschnitt „Umleitungs-URLs“ die URL des OAuth-Anbieters ein, an den Benutzer nach der Authentifizierung weitergeleitet werden, und wählen Sie Hinzufügenaus.
      Geben Sie https://Instanz.service-now.com/oauth_redirect.doein, wobei <Instanz> der Name Ihrer Instanz ServiceNow ist.
    14. Aktivieren Sie im Abschnitt „OAuth-Bereiche“ für die Organisationen: den Lesebereich für den OAuth-Bereich.
      OAuth-Bereiche geben die Zugriffsebene an, die die Anwendung auf Ihre geschützten Ressourcen hat. Mit dem OAuth-Bereich organizations:read kann Ihre Anwendung Informationen über Ihre Organisationen und Organisationsmitglieder lesen.

    Nächste Maßnahme

    Halten Sie Ihr Organisationsprofil geöffnet, damit Sie SCIM (System für domänenübergreifendes Identitätsmanagement) für Ihren Account Miro Enterprise aktivieren können. Weitere Informationen finden Sie unter Aktivieren Sie SCIM für Ihren Account Miro Enterprise ..

    Aktivieren Sie SCIM für Ihren Account Miro Enterprise .

    Aktivieren Sie SCIM (System für domänenübergreifendes Identitätsmanagement) in Ihrem Konto Miro Enterprise, damit Sie ein API-Zugriffstoken für die Authentifizierung Ihrer Miro API-Anforderungen generieren können.

    Vorbereitungen

    Miro Erforderliche Rolle: Siehe Tabelle „Mindestbenutzerberechtigungen“.

    Prozedur

    1. Wählen Sie im linken Navigationsbereich Ihres Organisationsprofils MiroSecurity (Sicherheit)aus.
    2. Wählen Sie auf der Seite „Sicherheit“ die Option SSO/SAML aktivieren aus.
    3. Nachdem SSO/SAML aktiviert wurde, wählen Sie die Option zum Aktivieren der SCIM-Bereitstellungaus.
      Miro generiert Ihr API-Zugriffstoken automatisch und zeigt es im Feld API-Token an.
    4. Wahlweise: Aktivieren Sie das Kontrollkästchen E-Mail-Benachrichtigungen an von SCIM bereitgestellte Anwender senden, damit Miro E-Mail-Benachrichtigungen an alle Anwender senden kann, die über SCIM bereitgestellt wurden.
    5. Kopieren Sie das API-Zugriffstoken im Feld API-Token.
      Speichern Sie sie zur späteren Verwendung an einem sicheren Ort.

    Erstellen Sie eine Miro Enterprise -Verbindung

    Stellen Sie eine Verbindung zwischen Ihren Miro Enterprise -Anwendungen und Ihrer ServiceNow -Instanz her.

    Vorbereitungen

    ServiceNow Erforderliche Rolle: admin

    Prozedur

    1. Navigieren Sie in Ihrer Instanz von ServiceNow zu Prozessautomatisierung > Flow Designer.
      Flow Designer wird auf einer neuen Registerkarte gestartet.
    2. Wählen Sie die Registerkarte Integrationen aus, und suchen Sie dann nach Miro.
    3. Wählen Sie Details für Ihre Miro Enterprise -Verbindung anzeigen.
    4. Wählen Sie in Ihren Miro Enterprise -Verbindungsdetails die Option Konfigurierenaus.
    5. Füllen Sie im Dialogfeld „Verbindung erstellen“ die Felder aus.
      Tabelle : 3. Dialogfeld „Verbindung erstellen“.
      Feld Beschreibung
      Verbindungsinformation
      Verbindungsname Name der Miro Enterprise -Verbindung. Dieses Feld wird automatisch ausgefüllt.
      Anmeldedaten
      OAuth-Client-ID Client-ID, die Ihrer Miro Enterprise OAuth 2.0-Anwendung zugewiesen ist.
      OAuth-Client-Geheimnis Geheimer Clientschlüssel, der Ihrer Miro Enterprise OAuth 2.0-Anwendung zugewiesen ist.
      OAuth-Umleitungs-URL URL des OAuth-Anbieters, zu dem Anwender nach der Authentifizierung weitergeleitet werden.

      Dieses Feld wird automatisch basierend auf der Umleitungs-URL ausgefüllt, die Sie in Erstellen Sie eine Miro Enterprise OAuth 2.0-Anwendungangegeben haben.
    6. Wählen Sie OAuth-Token erstellen und abrufen aus.
      Wichtig:

      Dieser Schritt muss von einem ServiceNow -Administrator mit der Rolle „Unternehmensadministrator“ in Miroausgeführt werden.

    7. Suchen Sie im Dialogfeld Miro OAuth-Autorisierung das Team, für das Sie die Anwendung Miro Enterprise OAuth 2.0 erstellt haben, und wählen Sie Installierenaus.
      Hinweis:
      Wenn eine andere Instanz ServiceNow von dieselben Anmeldeinformationen verwendet, werden Sie zu einer Neuinstallation aufgefordert.
      Das OAuth-Zugriffstoken wird für die Autorisierung Ihrer Miro Enterprise -Verbindung verfügbar.

    Erstellen Sie eine Miro Enterprise -SCIM-Verbindung

    Stellen Sie eine Verbindung zwischen dem SCIM-System Miro Enterprise und Ihrer Instanz ServiceNow her.

    Vorbereitungen

    ServiceNow Erforderliche Rolle: admin

    Prozedur

    1. Navigieren Sie in Ihrer Instanz von ServiceNow zu Prozessautomatisierung > Flow Designer.
      Flow Designer wird auf einer neuen Registerkarte gestartet.
    2. Wählen Sie die Registerkarte Integrationen aus, und suchen Sie dann nach Miro.
    3. Wählen Sie Details für Ihre Miro Enterprise SCIM-Verbindung anzeigen.
    4. Wählen Sie in Ihren Miro Enterprise SCIM-Verbindungsdetails die Option Konfigurieren aus.
    5. Füllen Sie im Dialogfeld „Verbindung erstellen“ die Felder aus.
      Tabelle : 4. Dialogfeld „Verbindung erstellen“.
      Feld Beschreibung
      Verbindungsinformation
      Verbindungsname Name der Miro Enterprise SCIM-Verbindung. Dieses Feld wird automatisch ausgefüllt.
      Anmeldedaten
      API-Token API-Zugriffstoken für die Authentifizierung von Miro API-Anforderungen.

      Geben Sie dasselbe API-Zugriffstoken ein, das Sie in Aktivieren Sie SCIM für Ihren Account Miro Enterprise .generiert und kopiert haben.
    6. Wählen Sie Verbindung erstellen aus.

    Miro Enterprise-Integrationsprofile erstellen

    Erstellen Sie ein Miro Enterprise-Integrationsprofil, um -Softwareabonnements nachzuverfolgen und die Lizenzierung für Ihre Miro Enterprise-Anwendungen zu optimieren.

    Vorbereitungen

    Zum Erstellen eines Miro Enterprise -Integrationsprofils fordern Sie das Plugin Software Asset Management - SaaS-Lizenzmanagement (sn_sam_saas_int) im ServiceNow Storean.

    ServiceNow Erforderliche Rolle: sam_integrator oder admin

    Wichtig:
    Sie müssen das Kontrollkästchen Miro-Spoke für diese Integration aktivieren, während Sie optionale Funktionen auf der Seite Application Manager installieren. Weitere Informationen zur Auswahl der erforderlichen SaaS-Anwendungen finden Sie unter SaaS-Lizenzmanagement anfordern.

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie Software-Asset-Arbeitsbereichverwenden, ist die Option zum Erstellen des Integrationsprofils Miro Enterprise in Core-UI inaktiv.

    Prozedur

    1. Navigieren Sie zum -Integrationsprofil.
      SchnittstelleAktion
      Core-UI
      1. Navigieren zu Alle > Software Asset > SaaS-Lizenz > Profile für direkte Integration.
      2. Wählen Sie Neu.
      3. Wählen Sie Miro-Enterprise-Integrationsprofilaus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Direkte Integrationsprofile.
      2. Wählen Sie Neu.
      3. Wählen Sie Miro Enterprise in der Dropdown-Liste aus.
      4. Wählen Sie Fortsetzen.
    2. Füllen Sie die folgenden Felder des Formulars aus.
      Tabelle : 5. Formular „Integrationsprofil“.
      Feld Beschreibung
      Anzeigename Name des Integrationsprofils. Beispiel: Miro Enterprise Integration.
      Status Status des Integrationsprofils.
      • Wenn Sie das Integrationsprofil nicht veröffentlicht haben, wird dieses Feld automatisch auf Entwurffestgelegt.
      • Wenn Sie das Integrationsprofil bereits veröffentlicht haben, wird dieses Feld automatisch auf Veröffentlichtgesetzt.
      Profiltyp Integrationsprofiltyp.

      Dieses Feld wird automatisch auf Miro Enterprise-Abonnementfestgelegt.
    3. Überprüfen Sie die erforderlichen Anwenderrollen oder API-Berechtigungen, die im Feld Lieferantenkonfiguration für jeden Prozess angegeben sind, um Sicherheitsrisiken zu minimieren und SaaS -Lizenzen zu optimieren.
      Hinweis:
      Weitere Informationen zu den erforderlichen Rollen und Bereichen finden Sie unter Tabelle der minimalen Benutzerberechtigungen.
      1. Stellen Sie im Abschnitt „Subflow zum Herunterladen von Abonnements“ sicher, dass das Feld „Subflow“ auf Miro-Download-Abonnementsfestgelegt ist.
        Hinweis:
        Das Kontrollkästchen Abonnements herunterladen ist standardmäßig aktiviert und kann nicht deaktiviert werden.
      2. Vergewissern Sie sich im Abschnitt „Subflow zum Zurückfordern des Abonnements“, dass das Feld „Subflow“ auf Miro – Abonnement zurückfordernfestgelegt ist.
        Hinweis:
        Das Kontrollkästchen Abonnements zurückfordern ist standardmäßig aktiviert. Wenn Sie Abonnements nicht zurückfordern möchten, können Sie dieses Kontrollkästchen deaktivieren. Wenn Sie diese Option löschen, werden die Entfernungskandidaten erstellt, aber der Subflow zum Zurückfordern des Abonnements wird nicht ausgelöst oder der Reklamationsprozess nicht initiiert.
    4. Wählen Sie Speichern, nachdem Sie alle erforderlichen Felder ausgefüllt haben.
      Ihre Instanz ServiceNow erstellt einen Integrationsprofilentwurf.
    5. Wählen Sie im Formular „Integrationsprofil“ Verbindung validieren aus, um die Verbindungs- und Anmeldeinformationsdetails dieser Integration zu überprüfen.

      Durch das Validieren der Verbindung werden die Download Subscriptions APIs, aber nicht die Reclaim Subscriptions APIs überprüft.

    6. Nachdem die Verbindung validiert wurde, wählen Sie Veröffentlichenaus.
    7. Wählen Sie im Dialogfeld „Bestätigung veröffentlichen“ die Option OKaus.

    Nächste Maßnahme

    Nachdem die Integration hergestellt wurde, erstellt Ihre Instanz ServiceNow automatisch Softwaremodelle, Reklamationsregeln und Softwareabonnements, die täglich aktualisiert werden.

    Wenn Sie mehrere Integrationsprofile mit eindeutigen Verbindungen einrichten möchten, erstellen Sie untergeordnete Aliasse, um verschiedene Konfigurationen und Einstellungen für jedes Integrationsprofil zu verwalten. Weitere Informationen finden Sie unter Erstellen Sie einen untergeordneten Alias, um mehrere Integrationsprofile einzurichten.

    Überprüfen Sie alle automatisch generierten Reklamationsregeln, um Anwenderabonnements zurückzufordern. Weitere Informationen finden Sie unter Überprüfen Sie eine Softwarereklamationsregel.

    Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software im Vergleich zu eigener Software nachzuverfolgen.
    Der Abgleich wird für Ihre Abonnements auch als geplante Aufgabe oder bei Bedarf ausgeführt. Sie können Ihre Abgleichergebnisse in der Lizenz-Workbench (Software Asset Management klassische Anwendung) oder in der Ansicht Lizenznutzung (Software Asset Workspace) anzeigen. Verwenden Sie diese Ergebnisse, um Ihre Position bei der Lizenz-Compliance zu bestimmen und etwaige Nichteinhaltungen zu beheben.