Verwerking Power Query van connectors

In Power BI wordt het laden van aangepaste connectors beperkt door de beveiligingsinstelling van uw keuze. Als de beveiliging voor het laden van aangepaste connectors is ingesteld op Aanbevolen, worden de aangepaste connectors over het algemeen helemaal niet geladen en moet u deze verlagen om ze te laden.

De uitzondering hierop is vertrouwde, 'ondertekende connectors'. Ondertekende connectors zijn een speciale indeling van aangepaste connectors, een PQX-bestand in plaats van een MEZ-bestand, dat is ondertekend met een certificaat. De gebruiker of de IT-afdeling van de gebruiker kan een vingerafdruk van de handtekening verstrekken, die in het register kan worden opgenomen om veilig aan te geven dat een bepaalde connector wordt vertrouwd.

Met de volgende stappen kunt u een certificaat gebruiken (met uitleg over het genereren van een certificaat als u er nog geen hebt) en een aangepaste connector ondertekenen met het hulpprogramma MakePQX.

Notitie

Als u hulp nodig hebt bij het maken van een zelfondertekend certificaat om deze instructies te testen, gaat u naar de Microsoft-documentatie over New-SelfSignedCertificate in PowerShell.

Notitie

Als u hulp nodig hebt bij het exporteren van uw certificaat als pfx, gaat u naar Export-PfxCertificate.

  1. Download MakePQX.

  2. Extraheer de MakePQX-map in het meegeleverde zip-bestand naar het beoogde doel.

  3. Als u deze wilt uitvoeren, roept u MakePQX aan in de opdrachtregel. Hiervoor zijn de andere bibliotheken in de map vereist, zodat u niet alleen het uitvoerbare bestand kunt kopiëren. Als u zonder parameters wordt uitgevoerd, wordt de Help-informatie retourneren.

Gebruik: MakePQX [opties] [opdracht]

Opties:

Opties Description
-? |-h | --help Help-informatie tonen

Opdrachten:

Opdracht Beschrijving
Pack Maak een pqx-bestand.
Teken Ondertekent een niet-ondertekende pqx of tellers als pqx al is ondertekend. Gebruik de optie --replace om de bestaande handtekening te vervangen.
Controleren Controleer de handtekeningstatus van een pqx-bestand. De retourwaarde is niet nul als de handtekening ongeldig is.

MakePQX heeft drie opdrachten. Gebruik MakePQX [opdracht] --help voor meer informatie over een opdracht.

Pack

Met de opdracht Pack wordt een mez-bestand ingepakt in een pqx-bestand, dat kan worden ondertekend. Het pqx-bestand biedt ook ondersteuning voor een aantal mogelijkheden die in de toekomst worden toegevoegd.

Gebruik: Opties voor [ MakePQX-pack ]

Opties:

Optie Beschrijving
-? |-h | --help Help-informatie tonen.
-mz | --mez Invoerextensiebestand.
-c | --certificate Certificaat (.pfx) dat wordt gebruikt om het extensiebestand te ondertekenen.
-p | --password Wachtwoord voor het certificaatbestand.
-t | --target Naam van uitvoerbestand. De standaardwaarde is dezelfde naam als het invoerbestand.

Voorbeeld

C:\Users\cpope\Downloads\MakePQX>MakePQX.exe pack -mz "C:\Users\cpope\OneDrive\Documents\Power BI Desktop\Custom Connectors\HelloWorld.mez" -t "C:\Users\cpope\OneDrive\Documents\Power BI Desktop\Custom Connectors\HelloWorldSigned.pqx"

Teken

Met de opdracht Ondertekenen ondertekent u uw pqx-bestand met een certificaat, waardoor het een vingerafdruk krijgt die kan worden gecontroleerd op vertrouwen door Power BI clients met de hogere beveiligingsinstelling. Deze opdracht neemt een pqx-bestand en retourneert hetzelfde pqx-bestand, ondertekend.

Gebruik: Opties voor [ MakePQX-tekenargumenten ] [ ]

Argumenten:

Argument Description
<pqx file> Het pad naar het pqx-bestand.

Opties:

Optie Beschrijving
-c | --certificate Certificaat (.pfx) dat wordt gebruikt om het extensiebestand te ondertekenen.
-p | --password Wachtwoord voor het certificaatbestand.
-r | --replace Vervang bestaande handtekening in plaats van tegentekenen.
-? |-h | --help Help-informatie tonen.

Voorbeeld

C:\Users\cpope\Downloads\MakePQX>MakePQX sign "C:\Users\cpope\OneDrive\Documents\Power BI Desktop\Custom Connectors\HelloWorldSigned.pqx" --certificate ContosoTestCertificate.pfx --password password

Verifiëren

Met de opdracht Verifiëren wordt gecontroleerd of de module correct is ondertekend en wordt de certificaatstatus weergegeven.

Gebruik: Opties voor [ makePQX-verificatieargumenten ] [ ]

Argumenten:

Argument Description
<pqx file> Het pad naar het pqx-bestand.

Opties:

Optie Beschrijving
-q | --quiet De uitvoer van handtekeningverificatie wordt verborgen.
-? |-h | --help Help-informatie tonen.

Voorbeeld

C:\Users\cpope\Downloads\MakePQX>MakePQX verify "C:\Users\cpope\OneDrive\Documents\Power BI Desktop\Custom Connectors\HelloWorldSigned.pqx"

{ 
  "SignatureStatus": "Success", 
  "CertificateStatus": [ 
    { 
      "Issuer": "CN=Colin Popell", 
      "Thumbprint": "16AF59E4BE5384CD860E230ED4AED474C2A3BC69", 
      "Subject": "CN=Colin Popell", 
      "NotBefore": "2019-02-14T22:47:42-08:00", 
      "NotAfter": "2020-02-14T23:07:42-08:00", 
      "Valid": false, 
      "Parent": null, 
      "Status": "UntrustedRoot" 
    } 
  ] 
} 

Ondertekende connectors vertrouwen in Power BI Desktop

Nadat u uw handtekening hebt geverifieerd, kunt u de vingerafdruk aan de eindgebruiker verstrekken om als vertrouwd te worden weergegeven. Meer informatie over het verstrekken van de vingerafdruk vindt u in Power BI documentatie.