Stackgini Katalog Konfigurieren

Inhaltsverzeichnis

Konfigurieren von Software-Zugriffanfrage-Routen
1. Zugriffanfrage-Routen für vorgeschlagene Software konfigurieren
2. Neue Software-Anfragerouten konfigurieren
Catalog in Drittanbieter-Plattformen einbetten

1. Konfigurieren von Software-Zugriffanfrage-Routen

Mit der Stackgini-Catalog-Konfiguration können Sie:

Globale und anwendungsspezifische Zugriffanfrage-Routen konfigurieren
Neue Software-Anfragen an Ihre Intake-Prozesse weiterleiten
Catalog in Drittanbieter-Plattformen wie ServiceNow, Freshservice, SharePoint, Confluence per iframe einbetten
Benutzerauthentifizierung und Autorisierung durch SSO beibehalten
Software-Zugriffanfrage-Routen per CSV oder API während der Portfolioeinrichtung importieren

Um auf die Catalog-Einstellungen zuzugreifen, gehen Sie zu Organisationseinstellungen > Allgemein. Dort finden Sie Konfigurationsoptionen für Anfragerouten und Einbettungsparameter unter Katalog.

a. Software-Zugriffanfrage-Routen für vorgeschlagene Software konfigurieren

Übersicht

Zugriffanfrage-Routen leiten Benutzer zum entsprechenden Workflow, wenn sie Software aus dem Stackgini Katalog auswählen. Wenn keine Zugriffanfrage-Route konfiguriert ist, wird die Schaltfläche für Zugriffanfragen nicht im Katalog angezeigt.

Stackgini unterstützt eine hierarchische Struktur mit zwei Ebenen:

Globale Standardroute: Gilt für alle Software-Lösungen in Ihrem Katalog, sofern nicht überschrieben
Anwendungsspezifische Routen: Einzelne Routen, die pro Applikation in Ihrem Portfolio konfiguriert sind

Globale Standardzugriffanfrage-Route einrichten

Die globale Standardroute gilt für alle Software-Applikationen in Ihrem Katalog, sofern einzelne Anwendungen nicht ihre eigenen benutzerdefinierten Routen konfiguriert haben.

So konfigurieren Sie die globale Standardroute:

Gehen Sie zu Organisationseinstellungen > Allgemein
Im Abschnitt Katalog und URL oder E-Mail für Zugriffsanfragen wählen Sie Ihren Routentyp:
- URL: Zum Weiterleiten an ein webbasiertes Anfragesystem
- E-Mail: Zum Weiterleiten von Anfragen an ein Intake-Postfach
Geben Sie die URL oder E-Mail-Adresse ein
Speichern Sie Ihre Änderungen

Wichtig: Wenn Sie diesen Abschnitt nicht konfigurieren, wird die Schaltfläche zum Anfordern des Zugriffs nicht für Software Applikationen in Ihrem Katalog angezeigt.

URL-Weiterleitung mit dynamischem Softwarenamen

Wenn Sie eine URL-Route verwenden, fügen Sie den {name}-Parameter ein, der durch den URI-codierten Anwendungsnamen ersetzt wird. Beispiel: Für Jira, um das Jira-Feld "Zusammenfassung" mit dem Anwendungsnamen auszufüllen.

https://your-domain.atlassian.net/servicedesk/customer/portal/1/create/3?summary=Request%20access%20to%20{name}

Wenn ein Benutzer "Microsoft Teams" auswählt, wird die URL zu:

https://your-domain.atlassian.net/servicedesk/customer/portal/1/create/3?summary=Request%20access%20to%Microsoft%20Teams

Beispielkonfigurationen:

ServiceNow: https://your-domain.service-now.com/now/nav/ui/classic/params/target/com.glideapp.servicecatalog_category_view.do%3Fv%3D1%26sysparm_parent%3D2809952237b1300054b6a3549dbe5dd4%26sysparm_catalog%3De0d08b13c3330100c8b837659bba8fb4%26sysparm_catalog_view%3Dcatalog_default%26sysparm_view%3Dcatalog_default
Jira: https://your-domain.atlassian.net/servicedesk/customer/portal/1/create/3?summary=Request%20access%20to%20{name}

Anwendungsspezifische Zugriffanfrage-Routen festlegen

Sie können verschiedene Zugriffanfrage-Routen für einzelne Applikationen in Ihrem Portfolio konfigurieren. Anwendungsspezifische Routen setzen die globale Standardroute für diese Anwendung außer Kraft.

So konfigurieren Sie eine anwendungsspezifische Route:

Öffnen Sie in Ihrem Portfolio die Anwendungsdetails und fügen Sie einen Eintrag im Feld "Lizenzanfrage" hinzu
Diese Route wird statt der globalen Standardroute verwendet, wenn Benutzer den Zugriff auf diese bestimmte Anwendung anfordern

Import per CSV oder API:

Anwendungsspezifische Routen können beim Auffüllen Ihres Portfolios per Bulk-Import importiert werden:

CSV-Import: Fügen Sie eine Spalte license_request mit URL- oder E-Mail-Werten für jede Anwendung ein
API-Import: Übergeben Sie den Parameter licenseRequest beim Erstellen oder Aktualisieren von Anwendungsdatensätzen (Weitere Informationen finden Sie auch hier: Swagger UI)

b. Neue Software-Anfragerouten konfigurieren

Anfrageroute für neue Software-Initiativen einrichten

Wenn Benutzer keine geeignete Software im Katalog finden, benötigen sie eine Möglichkeit, neue Software für Ihre Organisation vorzuschlagen. Diese Route leitet sie zu Ihrem Aufnahmeprozess für neue Software-Anfragen.

So konfigurieren Sie die Anfrageroute für neue Software:

Gehen Sie zu Organisationseinstellungen > Allgemein
Navigieren Sie zum Abschnitt Katalog
Geben Sie in der Sektion URL für Software-Anfragen die Ziel-URL ein
Lassen Sie das Feld leer, um das integrierte Software-Anfrage-Formular von Stackgini zu verwenden (empfohlen für neue Implementierungen)
Speichern Sie Ihre Änderungen

Wann eine benutzerdefinierte URL konfigurieren:

Ihre Organisation verfügt über einen dedizierten Genehmigungsworkflow für Software-Anfragen außerhalb von Stackgini
Sie leiten neue Software-Anfragen über ein bestehendes IT-Service-Management-System weiter

Beispielkonfigurationen:

ServiceNow: https://your-domain.service-now.com/now/nav/ui/classic/params/target/dmn_demand.do
Jira: https://your-domain.atlassian.net/servicedesk/customer/portal/1/group/4/create/109

Standardverhalten: Assistent zur Initiativenerstellung

Wenn kein Route im Feld URL für Software-Anfragen konfiguriert ist, verwendet das System standardmäßig den integrierten Assistenten zur Initiativenerstellung von Stackgini. Dies ist der empfohlene Ansatz für die meisten Organisationen.

2. Katalog in Drittanbieter-Plattformen einbetten

Das Einbetten vom Stackgini Katalog in Drittanbieter-Plattformen bringt Ihren internen Software-Marktplatz direkt in die bestehenden Arbeitsabläufe der Benutzer. Anstatt dass Benutzer zu einem separaten Portal navigieren müssen, ermöglicht die integrierte Katalog-Integration ihnen, Software zu entdecken und Zugriff anzufordern, ohne ServiceNow, SharePoint, Freshservice, Confluence oder eine irgendeine andere Plattform zu verlassen.

Wichtigste Vorteile der Einbettung:

Benutzer greifen auf Software-Entdeckung in ihren täglichen Tools und Arbeitsabläufen zu
Nahtlose Single-Sign-On (SSO) Authentifizierung ermöglicht reibungslosen Zugriff
Ermöglichen Sie Benutzern, neue Software in Freitextform anzufordern, auch wenn sie nicht bereits wissen, welche Software sie brauchen, sondern nur ein Problem haben, das sie mit einer Software lösen möchten
Fördern Sie die Wiederverwendung bestehender Systeme mit unserem intelligenten Katalog-Agent, der auch Alternativen aus Ihrem internen Software-Bestand empfehlen kann, wenn Benutzer Tools aus dem Markt anfordern, die Sie nicht haben

So funktioniert es:

Die Einbettung verwendet Standard-HTML-iframes, um die Stackgini-Katalog-Oberfläche innerhalb einer anderen Plattform anzuzeigen. Der iframe-Code ist auf allen Plattformen identisch. Die Domäne der Dritt-Plattform muss in Erlaubte Iframe-Domains von Stackgini aufgenommen werden, und SSO stellt sicher, dass Benutzer mit ihren bestehenden Organisationsanmeldedaten authentifiziert werden.

Die folgenden Abschnitte behandeln Voraussetzungen, unterstützte Plattformen und Implementierungsleitfäden für ServiceNow und andere Plattformen.

a. Voraussetzungen zum Einbetten des Stackgini Katalog

Vor dem Einbetten von Stackgini Katalog in Drittanbieter-Plattformen stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind.

Single-Sign-On (SSO) Konfiguration

Stackgini sollte mit dem SSO-Anbieter Ihrer Organisation (Azure AD usw.) konfiguriert werden. Dies stellt sicher, dass eine nahtlose Authentifizierung erfolgt, wenn Benutzer auf den eingebetteten Catalog zugreifen, ohne separate Anmeldedaten zu benötigen. Wenn SSO ordnungsgemäß konfiguriert ist, werden Benutzer automatisch auf der Grundlage ihrer bestehenden Sitzung authentifiziert, was ein reibungsloses Erlebnis bietet.

Benutzerzugriff und Azure-Gruppenbereitstellung

Alle Benutzer, die Zugriff auf den eingebetteten Katalog haben, müssen:

Zu den entsprechenden Stackgini-Benutzergruppen in Ihren AD-Gruppen hinzugefügt werden
Mitglieder von entsprechenden Azure AD-Gruppen sein (wenn Azure AD verwendet wird)
In Stackgini und der Drittanbieter-Plattform, in der der Katalog eingebettet ist, als Nutzer provisioniert werden (erfolgt automatisch für Stackgini, wenn sich der Benutzer in der entsprechenden Azure AD-Gruppe befindet, die den Zugriff auf Stackgini bietet)

Ausführliche Anleitungen zu SSO und Azure AD-Gruppenkonfiguration finden Sie im folgenden Artikel: Single-Sign-On (SSO)-Einrichtung über Azure AD/ENTRA ID

Unterstützte Plattformen

Der Stackgini Katalog kann in jede Plattform eingebettet werden, die benutzerdefinierte iframe-Einbettung unterstützt. Dies umfasst zum Beispiel:

ServiceNow (detailliert unten dokumentiert)
Microsoft SharePoint
Atlassian Confluence
Freshservice
Jede andere Plattform, die iframe-Einbettung unterstützt

Wichtig: Der Stackgini Catalog Einbettungscode verwendet einen Standard-HTML-iframe, der auf allen Plattformen funktioniert. Die einzige Anforderung ist, dass Ihre Plattform die Einbettung von benutzerdefinierten HTML-Elementen oder iframes unterstützt. Die Konfigurationsschritte können je nach Widget-Framework Ihrer Plattform leicht unterschiedlich sein, aber der zugrunde liegende iframe-Code bleibt unverändert.

b. Beispiel: ServiceNow-Implementierungsleitfaden

Dieser Abschnitt enthält Schritt-für-Schritt-Anleitungen zum Einbetten von Stackgini Catalog in ServiceNow.

Schritt 1: Zielseite in Ihrem Service Portal identifizieren

Bevor Sie das Widget konfigurieren, legen Sie fest, wo in Ihrem Service Portal Sie den Katalog anzeigen möchten. Erwägen Sie diese Optionen:

Erstellen Sie eine neue Seite mit dem Titel "Software-Katalog"
Einbettung auf einer bestehenden Seite "IT-Services" oder "Software-Anfrage"
Zur Homepage des Service Portals hinzufügen mit klarem Call-to-Action, z.B. "Software durchsuchen oder anfordern – Durchsuchen Sie den Software-Katalog nach benötigten Lösungen" (empfohlen)

Schritt 2: Benutzerdefiniertes Stackgini Katalog Widget erstellen

Melden Sie sich als Administrator bei ServiceNow an
Gehen Sie zum Filter Navigator (Suchfeld oben in ServiceNow) und suchen Sie nach Service Portal > Widgets
Klicken Sie auf Neu in der Listenansicht, um ein neues Widget zu erstellen
Geben Sie die Widget-Details ein:
- Name: Stackgini Catalog
- ID: stackgini_catalog
- Beschreibung: Eingebetteter Stackgini-Software-Katalog zum Anfordern von Softwarelösungen

Schritt 3: HTML-Template-Code hinzufügen

Ersetzen Sie auf der Registerkarte HTML Template den Standardinhalt durch folgenden iframe-Code, den Sie unter Organisationseinstellungen > Allgemein aus Stackgini kopieren können:

iframe-Code Beispiel (wird für Ihren Mandanten unterschiedlich sein)

html

<div class="iframe-container" style="width:100%; height:100vh;">   <iframe     src="https://app.softwaregini.com/your-tenant/embed/catalog"     style="width: 100%; height: 100%; min-width: 768px; border: none;"     allow="clipboard-write"   ></iframe> </div>

Die iframe-Code-Erklärung:

class="iframe-container": Container div mit voller Breite und Viewport-Höhe
src="https://app.softwaregini.com/your-tenant/embed/catalog": Ihre Stackgini-Embed-URL (Ihre Mandanten-URL wird vorkonfiguriert)
style="width: 100%; height: 100vh...": Macht den iframe responsiv und vollbildschirmfähig
min-width: 768px: Stellt eine Mindestbreite für optimale Darstellung sicher
allow="clipboard-write": Ermöglicht Zwischenablage-Funktionalität für Kopierfunktionen

Schritt 4: Client Script hinzufügen

Fügen Sie auf der Registerkarte Client Script folgende Controller-Code ein:

javascript

api.controller = function() {   /* widget controller */   var c = this; };

Dieser minimale Controller initialisiert das Widget. Sie können dies für zukünftige Verbesserungen erweitern, wie z.B. für benutzerdefinierte Analysen oder Event-Tracking.

Schritt 5: Server Script hinzufügen

Fügen Sie auf der Registerkarte Server Script folgenden Code ein:

javascript

(function() {   /* populate the 'data' object */   /* e.g., data.table = $sp.getValue('table'); */ })();

Dieser Handler steht für zukünftige Anpassungen zur Verfügung, wie zum Beispiel:

Protokollierung von Anfragen für Audit-Zwecke
Vorausfüllung von Benutzerinformationen aus ServiceNow

Schritt 6: CSS und Zugriffssteuerung konfigurieren

Auf der Registerkarte CSS können Sie diesen leer lassen (empfohlen) oder benutzerdefinierte Formatierungen hinzufügen.

Schritt 7: Widget zu Ihrer Service Portal Seite hinzufügen

Gehen Sie zum Filter Navigator und suchen Sie nach Service Portal > Konfiguration
Klicken Sie auf Designer
Öffnen Sie Ihr Ziel-Service Portal und wählen Sie die Seite aus, auf der Sie Catalog einbetten möchten, oder erstellen Sie sie
Im Service Portal Designer werden auf der linken Seitenleiste verfügbare Widgets und Layout-Tools angezeigt
Suchen Sie in der Widget-Liste nach Stackgini Catalog
Ziehen Sie das Stackgini Catalog Widget per Drag-and-Drop auf die Canvas an die gewünschte Position
Klicken Sie auf das Widget, um die Größe und Position anzupassen
Klicken Sie oben rechts auf Speichern, um Ihre Änderungen an der Seite zu speichern
Veröffentlichen oder bereitstellen Sie die Seite, um sie für Benutzer live zu schalten

Schritt 8: ServiceNow-Domäne in Stackgini registrieren

Damit Ihre ServiceNow-Instanz Catalog einbetten kann, müssen Sie sie in Stackgini registrieren:

Melden Sie sich bei Ihrem Stackgini-Mandanten an
Gehen Sie zu Organisationseinstellungen > Allgemein
Navigieren Sie zum Abschnitt Catalog
Fügen Sie in der Sektion Zulässige iframe-Domänen Ihre ServiceNow-Domäne hinzu (eine pro Zeile):

   https://your-instance.service-now.com

Speichern Sie die Änderungen (kann bis zu 5 Minuten dauern, bis die Änderungen wirksam werden)

Schritt 9: Integration testen

Greifen Sie auf Ihr Service Portal als normaler Benutzer zu
Navigieren Sie zur Seite mit dem eingebetteten Catalog
Überprüfen Sie folgendes:
- Stackgini Catalog wird ohne Fehler geladen
- SSO-Authentifizierung funktioniert korrekt
- Ein Klick auf Software-Elemente öffnet die konfigurierte Anfrageroute

c. Catalog in anderen Plattformen einbetten

Der Stackgini Catalog Einbettungscode ist plattformunabhängig und funktioniert in jeder Plattform, die benutzerdefinierte iframe-Einbettung unterstützt. Der HTML-iframe-Code bleibt auf allen Plattformen identisch. Nur die Konfigurationsschritte unterscheiden sich je nach Framework der jeweiligen Plattform.

SharePoint-Einbettung

Verwenden Sie das HTML Web Part (oder Embed Web Part), um den iframe-Code zu Ihrer SharePoint-Seite hinzuzufügen:

Bearbeiten Sie Ihre SharePoint-Seite
Fügen Sie ein "HTML Web Part" oder "Embed" Widget hinzu
Fügen Sie den iframe-Code in den HTML-Editor ein
Stellen Sie sicher, dass Ihre SharePoint-Domäne unter Allowed iframe domains in Organisationseinstellungen > Allgemein hinzugefügt wird (Catalog-Abschnitt)

Confluence-Einbettung

Verwenden Sie das HTML-Makro, um den iframe in Ihre Confluence-Seite einzubetten:

Bearbeiten Sie Ihre Confluence-Seite
Fügen Sie das HTML-Makro ein (oder HTML Include-Makro je nach Ihrer Version)
Fügen Sie den iframe-Code in das Makro ein
Stellen Sie sicher, dass Ihre Confluence-Domäne unter Allowed iframe domains in Organisationseinstellungen > Allgemein hinzugefügt wird (Catalog-Abschnitt)

Freshservice-Einbettung

Freshservice unterstützt die Einbettung externer Inhalte in sein IT Service Management Portal durch benutzerdefinierte Abschnitte und Widgets. Sie können Stackgini Catalog zu Ihrer Freshservice-Instanz hinzufügen, indem Sie benutzerdefinierte Abschnitte mit iframe-Unterstützung verwenden:

Melden Sie sich als Administrator bei Ihrer Freshservice-Instanz an
Gehen Sie zu Admin > Kontoeinstellungen > Service Desk Rebranding > Support Portal anpassen
Wenn Ihr Konto mehrere Arbeitsbereiche hat, navigieren Sie zu Admin > Globale Einstellungen > Kontoeinstellungen > Service Desk Rebranding > Support Portal anpassen
Klicken Sie auf die Homepage oder die Zielseite, um den Editor zu öffnen
Fügen Sie im Seiten-Designer einen benutzerdefinierten Abschnitt hinzu, indem Sie zwischen bestehenden Abschnitten hovern und auf die Schaltfläche + klicken
Wählen Sie ein Abschnittslayout (1-4 Spalten je nach Bedarf)
Fügen Sie in Ihrem Abschnitt ein Text-Widget hinzu oder erstellen Sie einen benutzerdefinierten HTML-Abschnitt
Kopieren und fügen Sie den iframe-Code in den HTML-Editor ein, den Sie unter Stackgini Organisationseinstellungen > Allgemein (Catalog-Abschnitt) erhalten
Speichern Sie Ihre Änderungen am Seiten-Layout
Stellen Sie sicher, dass Ihre Freshservice-Domäne unter Allowed iframe domains in Organisationseinstellungen > Allgemein hinzugefügt wird (Catalog-Abschnitt)
Testen Sie mit Beispielbenutzern, um SSO-Authentifizierung und Catalog-Funktionalität zu überprüfen

Hinweis: Freshservice erfordert, dass eingebettete Inhalte von der gleichen Domäne stammen oder ordnungsgemäße CORS-Header (Cross-Origin Resource Sharing) konfiguriert haben. Wenn Benutzer blockierte Inhalte sehen, arbeiten Sie mit dem Freshservice-Support zusammen, um sicherzustellen, dass Stackginis Domäne in Ihren Freshservice-Sicherheitsrichtlinien auf die Allowlist gesetzt ist.

Benutzerdefinierte Intranet-Portale

Für benutzerdefiniert erstellte Portale oder andere Plattformen:

Suchen Sie die Seitenvorlage oder den HTML-Editor, in den Sie Catalog einbetten möchten
Fügen Sie den iframe-Code direkt in die HTML der Seite ein
Fügen Sie Ihre Portal-Domäne unter Allowed iframe domains in Organisationseinstellungen > Allgemein hinzu (Catalog-Abschnitt)
Testen Sie mit Beispielbenutzern, um SSO-Authentifizierung und Funktionalität zu überprüfen

Allgemeine Richtlinien zur Einbettung

Für jede Plattform:

Der iframe-Code ist auf allen Plattformen gleich
SSO muss für nahtlose Authentifizierung konfiguriert werden
Ihre Plattform-Domäne muss unter Allowed iframe domains in Stackgini hinzugefügt werden
Content Security Policy (CSP) Header müssen für einige Plattformen möglicherweise angepasst werden
Die Mindesthöhe des iframe beträgt typischerweise 600px. Vollbildschirm-Höhe (100vh) wird empfohlen