Ρύθμιση διαπιστευτηρίων μέσω προγραμματισμού για το Power BI

ΙΣΕΙ ΓΙΑ: Τα δεδομένα ανήκουν στην εφαρμογή, τα δεδομένα ανήκουν στον χρήστη

Για να ρυθμίσετε διαπιστευτήρια μέσω προγραμματισμού για το Power BI, ακολουθήστε τα βήματα σε αυτό το άρθρο. Η ρύθμιση παραμέτρων διαπιστευτηρίων μέσω προγραμματισμού σάς επιτρέπει επίσης να κρυπτογραφείτε διαπιστευτήρια.

Σημείωμα

• Ο καλών χρήστης πρέπει να είναι κάτοχος μοντέλου σημασιολογίας ή διαχειριστής πύλης. Μπορείτε επίσης να χρησιμοποιήσετε μια κύρια υπηρεσία. Για παράδειγμα, η κύρια υπηρεσία μπορεί να είναι ο κάτοχος μοντέλου σημασιολογίας.
• Η διαχείριση των προελεύσεων δεδομένων cloud και των αντίστοιχων διαπιστευτηρίων τους γίνεται σε επίπεδο χρήστη.

Ενημέρωση της ροής διαπιστευτηρίων για προελεύσεις δεδομένων

1. Ανακαλύψτε τις προελεύσεις δεδομένων του μοντέλου σημασιολογίας καλώντας τη Λήψη προελεύσεων δεδομένων. Το σώμα της απόκρισης για κάθε προέλευση δεδομένων περιέχει τον τύπο, τις λεπτομέρειες σύνδεσης, την πύλη και το αναγνωριστικό προέλευσης δεδομένων.

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

2. Δημιουργήστε τη συμβολοσειρά διαπιστευτηρίων σύμφωνα με τα Παραδείγματα ενημέρωσης προέλευσης δεδομένων. Τα περιεχόμενα της συμβολοσειράς διαπιστευτηρίων εξαρτώνται από τον τύπο διαπιστευτηρίων.

   .NET SDK v3

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

   .NET SDK v2

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

   Σημείωμα

   Εάν χρησιμοποιείτε προελεύσεις δεδομένων cloud, μην ακολουθήσετε τα επόμενα βήματα σε αυτή την ενότητα. Καλέστε την Ενημέρωση προέλευσης δεδομένων για να ορίσετε τα διαπιστευτήρια, χρησιμοποιώντας το αναγνωριστικό πύλης και το αναγνωριστικό προέλευσης δεδομένων που λάβατε στο βήμα 1.

3. Ανακτήστε το δημόσιο κλειδί πύλης καλώντας τη Λήψη πύλης.

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

4. Κρυπτογραφήστε τα διαπιστευτήρια.

   .NET SDK v3

   var credentialsEncryptor = new AsymmetricKeyEncryptor(gateway.publicKey);
   

   .NET SDK v2

   Κρυπτογραφήστε τη συμβολοσειρά διαπιστευτηρίων με το δημόσιο κλειδί πύλης που λάβατε από το βήμα 2. Οι διαφορετικές εκδόσεις πύλης μπορεί να έχουν διαφορετικά μεγέθη δημόσιου κλειδιού. Ανατρέξτε στα παρακάτω παραδείγματα στον κώδικα SDK που είναι διαθέσιμα από το PowerBI-CSharp αποθετήριο δεδομένων GitHub:

   • AsymmetricKeyEncryptor.cs
   • Asymmetric1024KeyEncryptionHelper.cs
   • AsymmetricHigherKeyEncryptionHelper.cs
   • AuthenticatedEncryption.cs

5. Δημιουργήστε τις λεπτομέρειες διαπιστευτηρίων με κρυπτογραφημένα διαπιστευτήρια.

   .NET SDK v3

   Χρησιμοποιήστε την κλάση AsymetricKeyEncryptor με το δημόσιο κλειδί που ανακτήσατε στο βήμα 3.

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

   .NET SDK v2

   var credentialDetails = new CredentialDetails(
           credentials,
           CredentialTypeEnum.Basic,
           EncryptedConnectionEnum.Encrypted,
           EncryptionAlgorithmEnum.None,
           PrivacyLevelEnum.Private);
   

6. Ορίστε διαπιστευτήρια καλώντας την Ενημέρωση προέλευσης δεδομένων.

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

Ρύθμιση παραμέτρων νέας προέλευσης δεδομένων για μια πύλη δεδομένων

1. Εγκαταστήστε την πύλη δεδομένων εσωτερικής εγκατάστασης στον υπολογιστή σας.

2. Ανακτήστε το αναγνωριστικό πύλης και το δημόσιο κλειδί καλώντας τη Λήψη πυλών.

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

3. Δημιουργήστε λεπτομέρειες διαπιστευτηρίων, ακολουθώντας τη διαδικασία που περιγράφεται στην ενότητα Ενημέρωση ροής διαπιστευτηρίων για προελεύσεις δεδομένων, χρησιμοποιώντας το δημόσιο κλειδί πύλης που ανακτήσατε στο βήμα 2.

4. Δημιουργήστε το σώμα της αίτησης.

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

5. Καλέστε το API Δημιουργία προέλευσης δεδομένων.

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

Τύποι διαπιστευτηρίων

Όταν καλείτε τη Δημιουργία προέλευσης δεδομένων ή την Ενημέρωση προέλευσης δεδομένων από το Power BI REST API σε μια επιχειρησιακή πύλη εσωτερικής εγκατάστασης, κρυπτογραφήστε την τιμή διαπιστευτηρίων χρησιμοποιώντας το δημόσιο κλειδί πύλης.

Σημείωμα

Το .NET SDK v3 μπορεί επίσης να εκτελέσει τα παρακάτω παραδείγματα .NET SDK v2.

Windows και βασικά διαπιστευτήρια

.NET SDK v3

// 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);

.NET SDK v2

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

Βασικά διαπιστευτήρια

.NET SDK v3

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

.NET SDK v2

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

Διαπιστευτήρια OAuth2

.NET SDK v3

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

.NET SDK v2

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

Ανώνυμα διαπιστευτήρια

.NET SDK v3

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

.NET SDK v2

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

Αντιμετώπιση προβλημάτων

Δεν βρέθηκε αναγνωριστικό πύλης και προέλευσης δεδομένων κατά την κλήση προελεύσεων δεδομένων

Αυτό το πρόβλημα σημαίνει ότι το σημασιολογικό μοντέλο δεν συνδέεται σε μια πύλη. Όταν δημιουργείτε ένα νέο σημασιολογικό μοντέλο, δημιουργείται αυτόματα μια προέλευση δεδομένων χωρίς διαπιστευτήρια στην πύλη cloud του χρήστη για κάθε σύνδεση cloud. Η πύλη cloud χρησιμοποιείται για την αποθήκευση των διαπιστευτηρίων για συνδέσεις cloud.

Αφού δημιουργήσετε το σημασιολογικό μοντέλο, δημιουργείται μια αυτόματη σύνδεση μεταξύ του μοντέλου σημασιολογίας και μιας κατάλληλης πύλης, η οποία περιέχει αντίστοιχες προελεύσεις δεδομένων για όλες τις συνδέσεις. Η αυτόματη σύνδεση αποτυγχάνει εάν δεν υπάρχει κατάλληλη πύλη ή πύλες.

Εάν χρησιμοποιείτε σημασιολογικά μοντέλα εσωτερικής εγκατάστασης, δημιουργήστε τις προελεύσεις δεδομένων εσωτερικής εγκατάστασης που λείπουν και συνδέστε το σημασιολογικό μοντέλο σε μια πύλη με μη αυτόματο τρόπο, χρησιμοποιώντας τη δυνατότητα Σύνδεση σε πύλη.

Για να εντοπίσετε πύλες με δυνατότητα σύνδεσης, χρησιμοποιήστε τη δυνατότητα Ανακάλυψη πυλών.

Σχετικό περιεχόμενο

• Power BI REST API