Skip to content

Commit 6f71efc

Browse files
Court72Court72
authored
Merge pull request #247844 from msmbaldwin/phsm-show
Adding new tutorial article
2 parents 3df52c6 + 702168c commit 6f71efc

9 files changed

+98
-131
lines changed

‎articles/payment-hsm/create-different-ip-addresses.md

Lines changed: 3 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -421,32 +421,12 @@ New-AzureRmResourceGroupDeployment -Name $deploymentName -ResourceGroupName $res
421421

422422
---
423423

424-
## Validate the deployment
425-
426-
# [Azure CLI](#tab/azure-cli)
427-
428-
You can verify that the payment HSM was created with the Azure CLI [az dedicated-hsm list](/cli/azure/dedicated-hsm#az-dedicated-hsm-list) command. You will find the output easier to read if you format the results as a table:
429-
430-
```azurecli-interactive
431-
az dedicated-hsm list -o table
432-
```
433-
434-
# [Azure PowerShell](#tab/azure-powershell)
435-
436-
You can verify that the payment HSM was created with the Azure PowerShell [Get-AzDedicatedHsm](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet.
437-
438-
```azurepowershell-interactive
439-
Get-AzDedicatedHsm
440-
```
441-
---
442-
443-
You should see the name of your newly created payment HSM.
444-
445424
## Next steps
446425

447-
Advance to the next article to learn how to access the payShield manager for your payment HSM
426+
Advance to the next article to learn how to view your payment HSM.
448427
> [!div class="nextstepaction"]
449-
> [Access the payShield manager](access-payshield-manager.md)
428+
> [View your payment HSMs](view-payment-hsms.md)
429+
450430

451431
More resources:
452432

‎articles/payment-hsm/create-different-vnet-template.md

Lines changed: 2 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -416,32 +416,11 @@ New-AzureRmResourceGroupDeployment -Name $deploymentName -ResourceGroupName $res
416416

417417
---
418418

419-
## Validate the deployment
420-
421-
# [Azure CLI](#tab/azure-cli)
422-
423-
You can verify that the payment HSM was created with the Azure CLI [az dedicated-hsm list](/cli/azure/dedicated-hsm#az-dedicated-hsm-list) command. You will find the output easier to read if you format the results as a table:
424-
425-
```azurecli-interactive
426-
az dedicated-hsm list -o table
427-
```
428-
429-
# [Azure PowerShell](#tab/azure-powershell)
430-
431-
You can verify that the payment HSM was created with the Azure PowerShell [Get-AzDedicatedHsm](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet.
432-
433-
```azurepowershell-interactive
434-
Get-AzDedicatedHsm
435-
```
436-
---
437-
438-
You should see the name of your newly created payment HSM.
439-
440419
## Next steps
441420

442-
Advance to the next article to learn how to access the payShield manager for your payment HSM
421+
Advance to the next article to learn how to view your payment HSM.
443422
> [!div class="nextstepaction"]
444-
> [Access the payShield manager](access-payshield-manager.md)
423+
> [View your payment HSMs](view-payment-hsms.md)
445424
446425
More resources:
447426

‎articles/payment-hsm/create-different-vnet.md

Lines changed: 2 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -352,45 +352,11 @@ The Azure portal shows the "Private IP allocation method" as "Static":
352352

353353
---
354354

355-
## View your payment HSM
356-
357-
# [Azure CLI](#tab/azure-cli)
358-
359-
To see your payment HSM and its properties, use the Azure CLI [az dedicated-hsm show](/cli/azure/dedicated-hsm#az-dedicated-hsm-show) command.
360-
361-
```azurecli-interactive
362-
az dedicated-hsm show --resource-group "myResourceGroup" --name "myPaymentHSM"
363-
```
364-
365-
To list all of your payment HSMs, use the [az dedicated-hsm list](/cli/azure/dedicated-hsm#az-dedicated-hsm-list) command. (The output of this command is more readable when displayed in table-format.)
366-
367-
```azurecli-interactive
368-
az dedicated-hsm list --resource-group "myResourceGroup" -o table
369-
```
370-
371-
# [Azure PowerShell](#tab/azure-powershell)
372-
373-
To see your payment HSM and its properties, use the Azure PowerShell [Get-AzDedicatedHsm](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet.
374-
375-
```azurepowershell-interactive
376-
Get-AzDedicatedHsm -Name "myPaymentHSM" -ResourceGroup "myResourceGroup"
377-
```
378-
379-
To list all of your payment HSMs, use the [Get-AzDedicatedHsm](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet with no parameters.
380-
381-
To get more information on your payment HSM, you can use the [Get-AzResource](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet, specifying the resource group, and "Microsoft.HardwareSecurityModules/dedicatedHSMs" as the resource type:
382-
383-
```azurepowershell-interactive
384-
Get-AzResource -ResourceGroupName "myResourceGroup" -ResourceType "Microsoft.HardwareSecurityModules/dedicatedHSMs"
385-
```
386-
387-
---
388-
389355
## Next steps
390356

391-
Advance to the next article to learn how to access the payShield manager for your payment HSM
357+
Advance to the next article to learn how to view your payment HSM.
392358
> [!div class="nextstepaction"]
393-
> [Access the payShield manager](access-payshield-manager.md)
359+
> [View your payment HSMs](view-payment-hsms.md)
394360
395361
Additional information:
396362

‎articles/payment-hsm/create-payment-hsm.md

Lines changed: 2 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -347,45 +347,11 @@ The Azure portal shows the "Private IP allocation method" as "Dynamic":
347347

348348
---
349349

350-
## View your payment HSM
351-
352-
# [Azure CLI](#tab/azure-cli)
353-
354-
To see your payment HSM and its properties, use the Azure CLI [az dedicated-hsm show](/cli/azure/dedicated-hsm#az-dedicated-hsm-show) command.
355-
356-
```azurecli-interactive
357-
az dedicated-hsm show --resource-group "myResourceGroup" --name "myPaymentHSM"
358-
```
359-
360-
To list all of your payment HSMs, use the [az dedicated-hsm list](/cli/azure/dedicated-hsm#az-dedicated-hsm-list) command. (The output of this command is more readable when displayed in table-format.)
361-
362-
```azurecli-interactive
363-
az dedicated-hsm list --resource-group "myResourceGroup" -o table
364-
```
365-
366-
# [Azure PowerShell](#tab/azure-powershell)
367-
368-
To see your payment HSM and its properties, use the Azure PowerShell [Get-AzDedicatedHsm](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet.
369-
370-
```azurepowershell-interactive
371-
Get-AzDedicatedHsm -Name "myPaymentHSM" -ResourceGroup "myResourceGroup"
372-
```
373-
374-
To list all of your payment HSMs, use the [Get-AzDedicatedHsm](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet with no parameters.
375-
376-
To get more information on your payment HSM, you can use the [Get-AzResource](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet, specifying the resource group, and "Microsoft.HardwareSecurityModules/dedicatedHSMs" as the resource type:
377-
378-
```azurepowershell-interactive
379-
Get-AzResource -ResourceGroupName "myResourceGroup" -ResourceType "Microsoft.HardwareSecurityModules/dedicatedHSMs"
380-
```
381-
382-
---
383-
384350
## Next steps
385351

386-
Advance to the next article to learn how to access the payShield manager for your payment HSM
352+
Advance to the next article to learn how to view your payment HSM.
387353
> [!div class="nextstepaction"]
388-
> [Access the payShield manager](access-payshield-manager.md)
354+
> [View your payment HSMs](view-payment-hsms.md)
389355
390356
Additional information:
391357

‎articles/payment-hsm/faq.yml

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,7 @@ sections:
3939
- question: |
4040
How do I get started with the service?
4141
answer: |
42-
As Azure Payment HSM is a specialized service, customers should ask their Microsoft account manager and CSA to send a request [via email](mailto:[email protected]).
43-
42+
As Azure Payment HSM is a specialized service, customers should ask their Microsoft account manager and CSA to send a request [via email](mailto:[email protected]).
4443
- question: |
4544
What HSM SKUs are supported for Azure Payment HSM?
4645
answer: |
@@ -62,14 +61,13 @@ sections:
6261
Device licenses are required when applying custom firmware or returning to base firmware version. For license, contact Thales support with device serial number.
6362
6463
- question: |
65-
What kind of smart cards/readers are needed? how to use the smart cards?How many smart cards are needed?
64+
What kind of smart cards and readers are needed to access payShield manager?
6665
answer: |
67-
Compatible USB Smartcard reader supplied by Thales. With at least 5 payShield Manager cards available.
68-
69-
- question: |
70-
How do I know whether the smartcards I have are for payShield manager?
71-
answer: |
72-
Compatible smart cards have a blue band and are labeled with "payShield Manager Card" These are the only cards compatible with the ciphers used to enable use over network.
66+
Azure payment HSM comes with payShield Manager for customer to remotely manage the HSM. Compatible smart cards and smart card readers are required to access payShield Manager, and can be ordered directly from Thales:
67+
- **Item**: 971-000135-001-000
68+
- **Description**: PS10-RMGT-KIT2 - payShield Manager Starter Kit - for software V1.4A (1.8.3) and above
69+
- **Items Included**: 2 Thales Card Readers, 30 PayShield Manager Smartcards
70+
Compatible smart cards have a blue band and are labeled "payShield Manager Card". These are the only smart cards compatible with the ciphers used to enable over-network use.
7371
7472
- question: |
7573
How are physical keys are handled?
@@ -87,7 +85,7 @@ sections:
8785
Payshield 10k can be monitored using standard SNMP V3 tools. payShield Monitor is an additional product available to provide continuous monitoring of HSMs. Contact Thales Sales rep for licensing information.
8886
8987
- question: |
90-
How do I setup payShield monitor with Azure Payment HSM?
88+
How do I set up payShield monitor with Azure Payment HSM?
9189
answer: |
9290
Paysheild Monitor is distributed as a Virtual Machine and can be deployed on-premises or hosted in an Azure VM instance.
9391

‎articles/payment-hsm/media/portal-view-payment-hsm.png

88.6 KB
Loading

‎articles/payment-hsm/media/portal-view-payment-hsms.png

171 KB
Loading

‎articles/payment-hsm/toc.yml

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,11 @@
2121
href: create-different-vnet-template.md
2222
- name: Host and management port with IP addresses in different VNets
2323
href: create-different-ip-addresses.md
24-
- name: 2. Access the payShield manager for your payment HSM
24+
- name: 2. View your payment HSMs
25+
href: view-payment-hsms.md
26+
- name: 3. Access the payShield manager for your payment HSM
2527
href: access-payshield-manager.md
26-
- name: 3. Delete a commissioned payment HSM
28+
- name: 4. Delete a commissioned payment HSM
2729
href: remove-payment-hsm.md
2830

2931
- name: Quickstarts
@@ -40,7 +42,7 @@
4042
- name: Getting started with Azure Payment HSM
4143
href: getting-started.md
4244

43-
- name: Concepts
45+
- name: Compliance
4446
items:
4547
- name: Certification and compliance
4648
href: certification-compliance.md

‎articles/payment-hsm/view-payment-hsms.md

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
---
2+
title: View your Azure Payment HSMs
3+
description: View your Azure Payment HSMs
4+
services: payment-hsm
5+
ms.service: payment-hsm
6+
author: msmbaldwin
7+
ms.author: mbaldwin
8+
ms.topic: tutorial
9+
ms.custom: devx-track-azurepowershell, devx-track-azurecli
10+
ms.date: 08/09/2023
11+
---
12+
13+
# Tutorial: View your payment HSMs
14+
15+
After you have [created one or more Azure Payment HSMs](create-payment-hsm.md), you can view them (and validate their deployment) with Azure CLI, Azure PowerShell, or the Azure portal.
16+
17+
## View your payment HSM
18+
19+
# [Azure CLI](#tab/azure-cli)
20+
21+
To list all of your payment HSMs, use the [az dedicated-hsm list](/cli/azure/dedicated-hsm#az-dedicated-hsm-list) command. (The output of this command is more readable when displayed in table-format.)
22+
23+
```azurecli-interactive
24+
az dedicated-hsm list --resource-group "myResourceGroup" -o table
25+
```
26+
27+
To see a specific payment HSM and its properties, use the Azure CLI [az dedicated-hsm show](/cli/azure/dedicated-hsm#az-dedicated-hsm-show) command.
28+
29+
```azurecli-interactive
30+
az dedicated-hsm show --resource-group "myResourceGroup" --name "myPaymentHSM"
31+
```
32+
33+
# [Azure PowerShell](#tab/azure-powershell)
34+
35+
To list all of your payment HSMs, use the [Get-AzDedicatedHsm](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet with no parameters.
36+
37+
To get more information on your payment HSMs, you can use the [Get-AzResource](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet, specifying the resource group, and "Microsoft.HardwareSecurityModules/dedicatedHSMs" as the resource type:
38+
39+
```azurepowershell-interactive
40+
Get-AzResource -ResourceGroupName "myResourceGroup" -ResourceType "Microsoft.HardwareSecurityModules/dedicatedHSMs"
41+
```
42+
43+
To view a specific payment HSM and its properties, use the Azure PowerShell [Get-AzDedicatedHsm](/powershell/module/az.dedicatedhsm/get-azdedicatedhsm) cmdlet.
44+
45+
```azurepowershell-interactive
46+
Get-AzDedicatedHsm -Name "myPaymentHSM" -ResourceGroup "myResourceGroup"
47+
```
48+
49+
# [Azure portal](#tab/azure-portal)
50+
51+
52+
To view your payment HSMs in the Azure portal:
53+
54+
1. Sign in to the [Azure portal](https://portal.azure.com)
55+
1. Select "Resource groups".
56+
1. Select your resource group (e.g., "myResourceGroup").
57+
1. You will see your network interfaces, but not your payment HSMs. Select the "Show hidden types" box.
58+
:::image type="content" source="./media/portal-view-payment-hsms.png" lightbox="./media/portal-view-payment-hsms.png" alt-text="Screenshot of the Azure portal displaying all payment HSMs.":::
59+
1. You can select one of your payment HSMs to see its properties.
60+
:::image type="content" source="./media/portal-view-payment-hsm.png" lightbox="./media/portal-view-payment-hsm.png" alt-text="Screenshot of the Azure portal displaying a specific payment HSM and its properties.":::
61+
62+
---
63+
64+
## Next steps
65+
66+
Advance to the next article to learn how to access the payShield manager for your payment HSM
67+
> [!div class="nextstepaction"]
68+
> [Access the payShield manager](access-payshield-manager.md)
69+
70+
Additional information:
71+
72+
- Read an [Overview of Payment HSM](overview.md)
73+
- Find out how to [get started with Azure Payment HSM](getting-started.md)
74+
- See some common [deployment scenarios](deployment-scenarios.md)
75+
- Learn about [Certification and compliance](certification-compliance.md)
76+
- Read the [frequently asked questions](faq.yml)

0 commit comments

Comments
 (0)