Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mehrere Authentifizierungen (multi-auth) ist eine Funktion, die es Benutzern erlaubt, Verbindungen zu erstellen, indem sie die Möglichkeit haben, zu wählen, welche Authentifizierungsmethode sie zum Erstellen ihrer Verbindung verwenden möchten, anstatt nur auf einen Authentifizierungstyp beschränkt zu sein.
Definieren Sie eine Sammlung von Authentifizierungstypen für einen Connector durch connectionParameterSets in der apiProperties.json-Datei.
Wichtig
Der Assistent für benutzerdefinierte Connectors unterstützt die Aktivierung mehrerer Authentifizierungen für einen benutzerdefinierten Connector noch nicht. Verwenden Sie stattdessen Microsoft Power Platform Connectors CLI, um einen benutzerdefinierten Connector mit mehrstufiger Authentifizierung zu erstellen.
So aktivieren Sie Multi-Authentifizierung
Fügen Sie die connectionParameterSets in die Datei apiProperties.json ein, und füllen Sie die Sammlung connectionParameterSets.values mit so vielen connectionParameters, wie für den Konnektor benötigt werden.
Weitere Informationen zu Verbindungsparametern und Authentifizierungstypen finden Sie unter "Verbindungsparameter".
Wichtig
Wenn Ihr Connector OAuth verwendet, ist es wichtig, ablaufende Client-ID und geheime Anmeldeinformationen regelmäßig zu überwachen und zu erneuern, damit Kunden Ihren Connector weiterhin verwenden können. Stellen Sie sicher, dass Sie das Connectorupdate einen Monat vor dem Datum übermitteln, an dem Ihre Client-ID und der geheime Clientschlüssel ablaufen sollen.
Nachfolgend ist die Struktur von connectionParameterSets:
"connectionParameterSets": {
// uiDefinition for the parameter sets.
"uiDefinition": {
"displayname": "Select the authorization type",
"description": "<<Enter here your description>>"
},
"values": [
// Connection parameter set
{
"name": "<parameter set name>",
// uiDefinition for this parameter set.
"uiDefinition": {
"displayname": "<display name>",
"description": "<description text>"
},
"parameters": {
// Schema matches existing "connectionParameters"
"<parameter name>": {
"type": "string | securestring | oauthsetting"
},
"<parameter name>:clientId": {
"type": "string",
"uiDefinition": {
"schema": {
// For string types, the description must be placed in
// uiDefinition.schema.description to be shown in the description box
"type": "string",
"description": "<description text>"
},
"displayName": "<display name>",
}
}
}
},
{
"name": "<parameter set name 2>"
// ...
}
]
}
Beispiele
Konfiguration mit API-Schlüssel und Basic Authentication
"connectionParameterSets": {
"uiDefinition": {
"displayName": "Authentication Type",
"description": "Type of authentication to be used."
},
"values": [
{
"name": "basic-auth",
"uiDefinition": {
"displayName": "Use your X credentials",
"description": "Log in using your username and password for X."
},
"parameters": {
"username": {
"type": "string",
"uiDefinition": {
"displayName": "X username",
"schema":{
"description": "The username for X",
"type": "string"
},
"tooltip": "Provide your X username",
"constraints": {
"required": "true"
}
}
},
"password": {
"type": "securestring",
"uiDefinition": {
"displayName": "X password",
"schema":{
"description": "The password for X",
"type": "securestring"
},
"tooltip": "Provide your X password",
"constraints": {
"required": "true"
}
}
}
}
},
{
"name": "api-auth",
"uiDefinition": {
"displayName": "Use X API Key",
"description": "Log in using X's API Key."
},
"parameters": {
"api_key": {
"type": "securestring",
"uiDefinition": {
"constraints": {
"clearText": false,
"required": "true",
"tabIndex": 3
},
"schema":{
"description": "Enter your API Key for X",
"type": "securestring"
},
"displayName": "API Key generated in X"
}
},
"environment": {
"type": "string",
"uiDefinition": {
"displayName": "Environment",
"schema":{
"description": "The API environment to use; either production or sandbox",
"type": "string"
},
"tooltip": "Select an API environment to use",
"constraints": {
"required": "true",
"allowedValues": [
{
"text": "Sandbox",
"value": "YOUR_SANDBOX_VALUE_HERE"
},
{
"text": "Production",
"value": "YOUR_PROD_VALUE_HERE"
}
]
}
}
}
}
}
]
}
Konfiguration mit Entra ID und OAUTH 2.0
Sie können zwei Verbindungsparameter desselben Typs konfigurieren. In diesem Fall verwenden beide Autorisierungen den oauthSetting Typ. Eine Autorisierung ermöglicht es dem Benutzer, eine Verbindung mithilfe der Entra-ID zu erstellen, und die andere Autorisierung wechselt zu einem benutzerdefinierten Endpunkt.
"connectionParameterSets": {
"uiDefinition": {
"displayName": "Authentication Type",
"description": "Type of authentication to be used."
},
"values": [
{
"name": "aad-auth",
"uiDefinition": {
"displayName": "Use default shared application",
"description": "Log in using the standard X app."
},
"parameters": {
"token": {
"oAuthSettings": {
"clientId": "YOUR_AAD_APPLICATION_ID_HERE",
"customParameters": {
"loginUri": {
"value": "https://login.windows.net"
},
"resourceUri": {
"value": "https://graph.microsoft.com"
},
"tenantId": {
"value": "common"
}
},
"identityProvider": "aad",
"properties": {
"IsFirstParty": "False"
},
"redirectMode": "GlobalPerConnector",
"scopes": [
"Group.ReadWrite.All offline_access"
]
},
"type": "oauthSetting"
}
}
},
{
"name": "custom-app-auth",
"uiDefinition": {
"displayName": "Use the X authentication app",
"description": "Log in using X app."
},
"parameters": {
"token": {
"type": "oauthSetting",
"oAuthSettings": {
"clientId": "YOUR_CLIENT_ID_HERE",
"identityProvider": "oauth2",
"redirectMode": "GlobalPerConnector",
"customParameters": {
"authorizationUrl": {
"value": "https://login.dummy.net/request"
},
"refreshUrl": {
"value": "https://login.dummy.net/token"
},
"tokenUrl": {
"value": "https://login.dummy.net/token"
}
}
}
}
}
}
]
}
Ein aktuelles Beispiel zum Implementieren von Multiauth finden Sie unter RescoCloud-Connector.