Verbindung mit ConnectSSO herstellen - TIAPortal

TIA Portal Openness: API für die Automatisierung von Engineering-Workflows

ft:publication_title
TIA Portal Openness: API für die Automatisierung von Engineering-Workflows
Product
TIAPortal
Version
V20
Publication date
01/2025
Language
de-DE
Verbindung mit ConnectSSO herstellen

Voraussetzung

Verwendung

Sie können mit TIA Portal Openness ConnectSSO() aufrufen, wenn eine aktive SSO-Sitzung mit den nachfolgend aufgeführten Pflichtparametern verfügbar ist.

Parameter

Datentyp

Obligatorisch

Beschreibung

hostURL

System.String

Ja

Gibt den voll qualifizierten Teamcenter-Serverhost mit Portnummer an.

instance

System.String

Ja

Gibt die Teamcenter-Serverinstanz an.

loginURL

System.String

Ja

Legt die URL für den im Rahmen der Teamcenter Security Services konfigurierten Login-Dienst fest.

applicationID

System.String

Ja

Gibt die in der Registry der Teamcenter-Anwendung über den Identity-Dienst konfigurierte ID der Anwendung an.

Bei erfolgreich hergestellter Verbindung wird ein verschlüsseltes Objekt TcGatewayConnectionInfo zurückgegeben. Wird die Verbindung nicht erfolgreich hergestellt, wird eine entsprechende Ausnahme ausgegeben.

Hinweis

Ist keine aktive SSO-Sitzung verfügbar, werden Sie aufgefordert, Ihre Anmeldedaten für Teamcenter im Browser einzugeben, um eine SSO-Sitzung zu erstellen. Die API unterstützt das Anmelden mit Secure Card über PKI.

Programmcode

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

//Program code: ConnectSSO using TcGatewayConnectionInfo

private void ConnectingToTheConnectSSO()

{

    // Refer the Connecting to the TIA Portal section

    TiaPortal tiaPortal = new TiaPortal();

    // Retrieves the Teamcenter Gateway connection provider

    // from the TiaPortal instance using the GetService method.

    TeamcenterConnectionProvider tcGatewayProvider = tiaPortal.GetService<TeamcenterConnectionProvider>();

    // Replace with actual values

    string hostUrl = "host_url";

    string teamcenterInstance = "teamcenter_instance";

    string loginURL = "teamcenter SSO_login_service_url";

    String applicationId = "teamcenter_SSO_application";

    // Connect to Teamcenter SSO

    TcGatewayConnectionInfo connectionInfo = tcGatewayProvider.ConnectSSO(hostUrl,teamcenterInstance,loginURL,applicationId);

    // Retrieve connection details

    string group = connectionInfo.Group;

    string role = connectionInfo.Role;

}