Több hitelesítés hozzáadása egyéni összekötőhöz
A többszörös hitelesítés (multi-auth) egy olyan szolgáltatás, amely lehetővé teszi a felhasználók számára, hogy kapcsolatokat hozzanak létre azáltal, hogy lehetőséget biztosítanak számukra a kapcsolat létrehozásához használni kívánt hitelesítési módszer kiválasztására, ahelyett, hogy csak egy hitelesítési típusra korlátozódnának.
Csatlakozók esetében a hitelesítési típusok egy gyűjteményét a apiProperties.json connectionParameterSets fájlja definiálja.
Fontos
Az egyéni csatlakozók több hitelesítésének engedélyezése az Egyéni csatlakozó varázslóban még nem támogatott. A Microsoft Power Platform CLI csatlakozók használatával hozzon létre többhitelesítős egyéni csatlakozót.
A több hitelesítés engedélyezése
Adja hozzá a connectionParameterSets a apiProperties.json fájlhoz, és töltse ki a gyűjteményt connectionParameterSets.values annyi connectionParameters értékkel, amennyi szükséges az összekötőhöz.
Megjegyzés
A kapcsolatparaméterekkel és a hitelesítési típusokkal kapcsolatos további tudnivalókért keresse fel a Connection Parameterswebhelyet.
A következő a szerkezet: 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>"
// ...
}
]
}
Példák
Konfigurálás API-kulcssal és alapszintű hitelesítéssel
"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"
}
]
}
}
}
}
}
]
}
Konfiguráció Entra ID-vel és OAUTH 2.0-val
Lehetséges, hogy két azonos típusú connectionParameters legyen. Ebben az esetben mindkét jogosultság típust használ oauthSetting : az egyik lehetővé teszi a felhasználó számára, hogy kapcsolatot hozzon létre az Entra ID használatával, míg a másik egy egyéni végpont megy.
"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"
}
}
}
}
}
}
]
}
Tekintse meg a RescoCloud csatlakozót itt, ahol egy aktuális példát talál a többszöri hitelesítés megvalósításáról.