Invoke-AzKeyVaultKeyOperation

  • Referencia
Modul:
Az.KeyVault

Olyan műveleteket hajt végre, mint a "Titkosítás", a "Visszafejtés", a "Wrap" vagy a "Unwrap" egy kulcstartóban vagy felügyelt hsm-ben tárolt megadott kulccsal.

Syntax

Invoke-AzKeyVaultKeyOperation
      [-Version <String>]
      -Operation <String>
      -Algorithm <String>
      [-Value <SecureString>]
      [-ByteArrayValue <Byte[]>]
      [-Name] <String>
      [-VaultName] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzKeyVaultKeyOperation
      [-Version <String>]
      -Operation <String>
      -Algorithm <String>
      [-Value <SecureString>]
      [-ByteArrayValue <Byte[]>]
      [-HsmName] <String>
      [-Name] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzKeyVaultKeyOperation
      [-Version <String>]
      -Operation <String>
      -Algorithm <String>
      [-Value <SecureString>]
      [-ByteArrayValue <Byte[]>]
      [-InputObject] <PSKeyVaultKeyIdentityItem>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Az Invoke-AzKeyVaultKeyOperation parancsmag támogatja

  1. Tetszőleges bájtsorozat titkosítása titkosítási kulccsal.
  2. Titkosított adatok egyetlen blokkjának visszafejtése.
  3. Szimmetrikus kulcs körbefuttatása megadott kulccsal.
  4. Szimmetrikus kulcs kibontása a kulcs burkolásához eredetileg használt megadott kulccsal.

Példák

1. példa: A bájttömb titkosítása titkosítási kulccsal

$byteArray = [Byte[]]@(58, 219)
$encryptedData = Invoke-AzKeyVaultKeyOperation -Operation Encrypt -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $byteArray
$encryptedData

KeyId     : https://bez-kv.vault.azure.net/keys/bez-key/c96ce0fb18de446c9f4b911b686988af
RawResult : {21, 39, 82, 56…}
Algorithm : RSA1_5

A $byteArray a test-kv fájlban tárolt tesztkulcs használatával titkosítja.

2. példa: Bájttömb visszafejtése titkosítási kulccsal

$decryptedData = Invoke-AzKeyVaultKeyOperation -Operation Decrypt -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $encryptedData.RawResult
$decryptedData

KeyId     : https://bez-kv.vault.azure.net/keys/bez-key/c96ce0fb18de446c9f4b911b686988af
RawResult : {58, 219}
Algorithm : RSA1_5

Visszafejtés $encryptedData.RawResult a test-kv fájlban tárolt tesztkulcs használatával. Ugyanaz $decryptedData.RawResult , mint az $byteArrayeredeti adatokkal.

3. példa: Egyszerű szöveg titkosítása titkosítási kulccsal

$encryptedData = Invoke-AzKeyVaultKeyOperation -Operation Encrypt -Algorithm RSA1_5 -VaultName test-kv -Name test-key -Value (ConvertTo-SecureString -String "test" -AsPlainText -Force)
$encryptedData

KeyId     : https://test-kv.vault.azure.net/keys/test-key/bd8b77352a2443d4983bd70e9f660bc6
RawResult : {58, 219, 6, 236…}
Algorithm : RSA1_5

A "test" sztringet a test-kv fájlban tárolt tesztkulcs használatával titkosítja. Ez RawResult a titkosított eredmény bájttömb formátumban, ahol a [System.Convert]::ToBase64String($encryptedData.RawResult) értéke $encryptedData.Result.

4. példa: Titkosított adatok visszafejtése egyszerű szöveggé

$decryptedData = Invoke-AzKeyVaultKeyOperation -Operation Decrypt -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $encryptedData.RawResult
$decryptedData

KeyId     : https://bez-kv.vault.azure.net/keys/bez-key/c96ce0fb18de446c9f4b911b686988af
RawResult : $byteArray
Algorithm : RSA1_5

A test-kv fájlban tárolt tesztkulcs használatával titkosított titkosított adatok visszafejtése. Az $decryptedData.Result is test. A RawResult visszafejtett eredmény bájttömb formátumban, ahol a [System.Text.UTF8Encoding]::UTF8. A GetString($decryptedData.RawResult) értéke $decryptedData.Result.

5. példa: Szimmetrikus kulcs körbefuttatása megadott kulccsal

$wrappedResult = Invoke-AzKeyVaultKeyOperation -Operation Wrap -Algorithm RSA1_5 -VaultName test-kv -Name test-key -Value (ConvertTo-SecureString -String "ovQIlbB0DgWhZA7sgkPxbg9H-Ly-VlNGPSgGrrZvlIo" -AsPlainText -Force) 

$wrappedResult | Format-List

KeyId     : https://test-kv.vault.azure.net/keys/test-key/375cdf20252043b79c8ca0c57b6c7679
RawResult : {58, 219, 6, 236…}
Algorithm : RSA1_5

Szimmetrikus kulcs körbefuttatása a test-kv fájlban tárolt tesztkulcs nevű kulccsal. A Result becsomagolt eredmény Base64 sztringformátumban van.

6. példa: Szimmetrikus kulcs feloldása megadott kulccsal

Invoke-AzKeyVaultKeyOperation -Operation Unwrap -Algorithm RSA1_5 -VaultName test-kv -Name test-key -Value (ConvertTo-SecureString -String $result.Result -AsPlainText -Force)

KeyId     : https://test-kv.vault.azure.net/keys/test-key/375cdf20252043b79c8ca0c57b6c7679
RawResult : {58, 219, 6, 236…}
Algorithm : RSA1_5

Szimmetrikus kulcs leválasztása a test-kv fájlban tárolt megadott kulcs tesztkulcsával. Ez Result egy egyszerű sztring.

Paraméterek

-Algorithm

Algoritmusazonosító

Type:String
Aliases:EncryptionAlgorithm, WrapAlgorithm
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ByteArrayValue

A bájttömb formátumban üzemeltetendő érték.

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HsmName

HSM-név.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Kulcsobjektum

Type:PSKeyVaultKeyIdentityItem
Aliases:Key
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Kulcsnév.

Type:String
Aliases:KeyName
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Operation

Algoritmusazonosító

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value

A működtetni kívánt érték. Ez a paraméter UTF-8 kódolási módon konvertálódik bájttömbté. Ha az UTF-8 nem tudja kódolni az értéket, használja a ByteArrayValue paramétert alternatívaként.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultName

Tároló neve.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Version

Kulcsverzió.

Type:String
Aliases:KeyVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

PSKeyVaultKeyIdentityItem

Kimenetek

PSKeyOperationResult