Konfigurera autentiseringsuppgifter programmatiskt för Power BI

GÄLLER FÖR: Appen äger data Användaren äger data

Följ stegen i den här artikeln om du vill konfigurera autentiseringsuppgifter programmatiskt för Power BI. Genom att konfigurera autentiseringsuppgifter programmatiskt kan du även kryptera autentiseringsuppgifter.

Uppdatera autentiseringsuppgifternas flöde för datakällor

1. Identifiera semantikmodellens datakällor genom att anropa Hämta datakällor. Svarstexten för varje datakälla innehåller typ, anslutningsinformation, gateway och datakällans ID.

   // Select a datasource
   var datasources = pbiClient.Datasets.GetDatasources(datasetId).Value;
   var datasource = datasources.First();
   

2. Skapa autentiseringsuppgifterna enligt Exempel på uppdateringsdatakälla. Innehållet i autentiseringsuppgifternas sträng beror på typen av autentiseringsuppgifter.

   • .NET SDK v3
   • .NET SDK v2

   var credentials =  new BasicCredentials(username: "username", password :"*****");
   

   Kommentar

   Om du använder molndatakällor följer du inte nästa steg i det här avsnittet. Anropa Uppdatera datakälla för att ange autentiseringsuppgifterna med hjälp av gateway-ID:t och datakäll-ID:t som du fick i steg 1.

3. Hämta den offentliga gatewaynyckeln genom att anropa Hämta gateway.

   var gateway = pbiClient.Gateways.GetGatewayById(datasource.GatewayId);
   

4. Kryptera autentiseringsuppgifterna.

   • .NET SDK v3
   • .NET SDK v2

   var credentialsEncryptor = new AsymmetricKeyEncryptor(gateway.publicKey);
   

5. Skapa information om autentiseringsuppgifter med krypterade autentiseringsuppgifter.

   • .NET SDK v3
   • .NET SDK v2

   Använd klassen AsymetricKeyEncryptor med den offentliga nyckeln som hämtades i steg 3.

   var credentialDetails = new CredentialDetails(
           credentials,
           PrivacyLevel.Private,
           EncryptedConnection.Encrypted,
           credentialsEncryptor);
   

6. Ange autentiseringsuppgifter genom att anropa Uppdatera datakälla.

   pbiClient.Gateways.UpdateDatasource(datasource.GatewayId.Value, datasource.DatasourceId.Value, new UpdateDatasourceRequest(credentialDetails));
   

Konfigurera en ny datakälla för en datagateway

1. Installera den lokala datagatewayen på datorn.

2. Hämta gateway-ID:t och den offentliga nyckeln genom att anropa Hämta gatewayer.

   // Select a gateway
   var gateways = pbiClient.Gateways.GetGateways().Value;
   var gateway = gateways.First();
   

3. Skapa information om autentiseringsuppgifter genom att följa den procedur som beskrivs i avsnittet uppdatera autentiseringsuppgifter för datakällor med hjälp av den offentliga gatewaynyckel som du hämtade i steg 2.

4. Skapa begärandetexten.

   var request = new PublishDatasourceToGatewayRequest(
           dataSourceType: "SQL",
           connectionDetails: "{\"server\":\"myServer\",\"database\":\"myDatabase\"}",
           credentialDetails: credentialDetails,
           dataSourceName: "my sql datasource");
   

5. Anropa API:et Skapa datakälla .

   pbiClient.Gateways.CreateDatasource(gateway.Id, request);
   

Typer av autentiseringsuppgifter

När du anropar Skapa datakälla eller Uppdatera datakälla från Power BI REST API på en lokal företagsgateway krypterar du värdet för autentiseringsuppgifterna med hjälp av den offentliga gatewaynyckeln.

Windows och grundläggande autentiseringsuppgifter

// Windows credentials
var credentials = new WindowsCredentials(username: "john", password: "*****");

// Or

// Basic credentials
var credentials = new BasicCredentials(username: "john", password: "*****");

var credentialsEncryptor = new AsymmetricKeyEncryptor(publicKey);
var credentialDetails = new CredentialDetails(credentials, PrivacyLevel.Private, EncryptedConnection.Encrypted, credentialsEncryptor);

var credentials = "{\"credentialData\":[{\"name\":\"username\", \"value\":\"john\"},{\"name\":\"password\", \"value\":\"*****\"}]}";

Nyckelautentiseringsuppgifter

var credentials = new KeyCredentials("TestKey");
var credentialsEncryptor = new AsymmetricKeyEncryptor(publicKey);
var credentialDetails = new CredentialDetails(credentials, PrivacyLevel.Private, EncryptedConnection.Encrypted, credentialsEncryptor);

var credentials = "{\"credentialData\":[{\"name\":\"key\", \"value\":\"ec....LA=\"}]}";

OAuth2-autentiseringsuppgifter

var credentials = new OAuth2Credentials("TestToken");
var credentialsEncryptor = new AsymmetricKeyEncryptor(publicKey);
var credentialDetails = new CredentialDetails(credentials, PrivacyLevel.Private, EncryptedConnection.Encrypted, credentialsEncryptor);

var credentials = "{\"credentialData\":[{\"name\":\"accessToken\", \"value\":\"eyJ0....fwtQ\"}]}";

Anonyma autentiseringsuppgifter

var credentials = new AnonymousCredentials();
var credentialDetails = new CredentialDetails(credentials, PrivacyLevel.Private, EncryptedConnection.NotEncrypted);

var credentials = "{\"credentialData\":\"\"}";

Felsökning

Ingen gateway och datakällans ID hittas när du anropar hämta datakällor

Det här problemet innebär att den semantiska modellen inte är bunden till en gateway. När du skapar en ny semantisk modell skapas en datakälla utan autentiseringsuppgifter automatiskt på användarens molngateway för varje molnanslutning. Molngatewayen används för att lagra autentiseringsuppgifterna för molnanslutningar.

När du har skapat den semantiska modellen skapas en automatisk bindning mellan den semantiska modellen och en lämplig gateway som innehåller matchande datakällor för alla anslutningar. Den automatiska bindningen misslyckas om det inte finns någon lämplig gateway eller gateway.

Om du använder lokala semantiska modeller skapar du de lokala datakällor som saknas och binder semantikmodellen till en gateway manuellt med hjälp av Bind till gateway.

Om du vill identifiera gatewayer som kan bindas använder du Identifiera gatewayer.

Relaterat innehåll

• ,Power BI REST-API:er