Integration mit Miro Enterprise

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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
    Anwenderaktivität abrufen 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 erstellenaus.
    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.do ein, 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 aktivierenaus.
    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 Verbindungen.
    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.
      Geheimer OAuth-Schlüssel 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 von ServiceNow 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 Verbindungen.
    3. Wählen Sie Details für Ihre Miro Enterprise SCIM-Verbindung anzeigen.
    4. Wählen Sie in den SCIM-Verbindungsdetails von Miro Enterprise die Option Verbindung hinzufügenaus.
    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 (com.sn_sam_saas_int) im ServiceNow Storean.

    ServiceNow Erforderliche Rolle: sam_integrator oder admin

    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-Integrationsprofil aus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Profile für direkte Integration.
      2. Wählen Sie Neu.
      3. Wählen Sie Miro Enterprise in der Dropdown-Liste aus.
      4. Wählen Sie Fortsetzen aus.
    2. Füllen Sie die folgenden Felder des Formulars aus.
      Tabelle : 5. Formular „Integrationsprofil“.
      Feld Beschreibung
      Name 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. Stellen Sie auf der Registerkarte Subflow zum Herunterladen des Abonnements sicher, dass das Feld Verbindung und Anmeldeinformationen auf sn_miro_spoke.Miro_Enterprise und das Feld Subflow auf Miro Download Subscriptionsfestgelegt ist.
      Sie können Ereignisse anzeigen, die von einzelnen Anwendern bis zu einem Jahr vor dem aktuellen Datum durchgeführt wurden. Weitere Informationen finden Sie unter Überprüfen Sie eine Softwarereklamationsregel.
      Hinweis:
      Software Asset Management ruft die Ereignisse ab dem Zeitpunkt ab, zu dem Sie mit dem Herunterladen von Benutzerabonnements beginnen, unabhängig vom Datum der Profilerstellung.
    4. Stellen Sie auf der Registerkarte Subflow „Abonnement zurückfordern“ sicher, dass das Feld Verbindung und Anmeldeinformationen auf sn_miro_spoke.Miro_Enterprise_SCIM und das Feld Subflow auf Miro Abonnementzurückfordern festgelegt ist.
    5. Wählen Sie Speichern.
      Ihre Instanz ServiceNow erstellt einen Integrationsprofilentwurf. Das -Integrationsprofil verwendet die Subflows [ Miro Abonnements herunterladen und Miro Abonnement zurückfordern, um Benutzerdaten aus Ihren Miro Enterprise-Anwendungen abzurufen.
    6. Nachdem das Formular neu geladen wurde, wählen Sie Veröffentlichen.
      Das Dialogfeld „Bestätigung veröffentlichen“ wird geöffnet.
    7. Wählen Sie im Dialogfeld OK.

    Nächste Maßnahme

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

    Ü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.