fixed indents/spacing, bullets, metadata

Author: KarlErickson

articles/key-vault/certificates/quick-create-java.md

@@ -2,7 +2,7 @@
 title: Quickstart for Azure Key Vault Certificate client library - Java
 description: Learn about the the Azure Key Vault Certificate client library for Java with the steps in this quickstart.
 author: msmbaldwin
-ms.custom: devx-track-java, devx-track-azurecli, devx-track-azurepowershell, mode-api
+ms.custom: devx-track-java, devx-track-azurecli, devx-track-azurepowershell, mode-api, passwordless-java
 ms.author: mbaldwin
 ms.date: 11/14/2022
 ms.service: key-vault
@@ -12,16 +12,18 @@ ms.devlang: java
 ---
 
 # Quickstart: Azure Key Vault Certificate client library for Java (Certificates)
+
 Get started with the Azure Key Vault Certificate client library for Java. Follow the steps below to install the package and try out example code for basic tasks.
 
 Additional resources:
 
-* [Source code](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/keyvault/azure-security-keyvault-certificates)
-* [API reference documentation](https://azure.github.io/azure-sdk-for-java/keyvault.html)
-* [Product documentation](index.yml)
-* [Samples](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/keyvault/azure-security-keyvault-certificates/src/samples/java/com/azure/security/keyvault/certificates)
+- [Source code](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/keyvault/azure-security-keyvault-certificates)
+- [API reference documentation](https://azure.github.io/azure-sdk-for-java/keyvault.html)
+- [Product documentation](index.yml)
+- [Samples](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/keyvault/azure-security-keyvault-certificates/src/samples/java/com/azure/security/keyvault/certificates)
 
 ## Prerequisites
+
 - An Azure subscription - [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - [Java Development Kit (JDK)](/java/azure/jdk/) version 8 or above
 - [Apache Maven](https://maven.apache.org)
@@ -30,23 +32,26 @@ Additional resources:
 This quickstart assumes you are running [Azure CLI](/cli/azure/install-azure-cli) and [Apache Maven](https://maven.apache.org) in a Linux terminal window.
 
 ## Setting up
+
 This quickstart is using the Azure Identity library with Azure CLI to authenticate user to Azure Services. Developers can also use Visual Studio or Visual Studio Code to authenticate their calls, for more information, see [Authenticate the client with Azure Identity client library](/java/api/overview/azure/identity-readme).
 
 ### Sign in to Azure
+
 1. Run the `login` command.
 
-    ```azurecli-interactive
-    az login
-    ```
+   ```azurecli-interactive
+   az login
+   ```
 
    If the CLI can open your default browser, it will do so and load an Azure sign-in page.
 
    Otherwise, open a browser page at [https://aka.ms/devicelogin](https://aka.ms/devicelogin) and enter the
    authorization code displayed in your terminal.
 
-2. Sign in with your account credentials in the browser.
+1. Sign in with your account credentials in the browser.
 
 ### Create a new Java console app
+
 In a console window, use the `mvn` command to create a new Java console app with the name `akv-certificates-java`.
 
 ```console
@@ -88,6 +93,7 @@ cd akv-certificates-java
 ```
 
 ### Install the package
+
 Open the *pom.xml* file in your text editor. Add the following dependency elements to the group of dependencies.
 
 ```xml
@@ -105,39 +111,49 @@ Open the *pom.xml* file in your text editor. Add the following dependency elemen
 ```
 
 ### Create a resource group and key vault
+
 [!INCLUDE [Create a resource group and key vault](../../../includes/key-vault-rg-kv-creation.md)]
 
 #### Grant access to your key vault
+
 Create an access policy for your key vault that grants certificate permissions to your user account.
 
 ```azurecli
 az keyvault set-policy --name <your-key-vault-name> --upn [email protected] --certificate-permissions delete get list create purge
 ```
 
 #### Set environment variables
+
 This application is using your key vault name as an environment variable called `KEY_VAULT_NAME`.
 
 Windows
+
 ```cmd
 set KEY_VAULT_NAME=<your-key-vault-name>
 ````
+
 Windows PowerShell
+
 ```powershell
 $Env:KEY_VAULT_NAME="<your-key-vault-name>"
 ```
 
 macOS or Linux
+
 ```cmd
 export KEY_VAULT_NAME=<your-key-vault-name>
 ```
 
 ## Object model
+
 The Azure Key Vault Certificate client library for Java allows you to manage certificates. The [Code examples](#code-examples) section shows how to create a client, create a certificate, retrieve a certificate, and delete a certificate.
 
 The entire console app is [below](#sample-code).
 
 ## Code examples
+
 ### Add directives
+
 Add the following directives to the top of your code:
 
 ```java
@@ -154,6 +170,7 @@ import com.azure.security.keyvault.certificates.models.KeyVaultCertificateWithPo
 ```
 
 ### Authenticate and create a client
+
 In this quickstart, a logged in user is used to authenticate to Key Vault, which is preferred method for local development. For applications deployed to Azure, a Managed Identity should be assigned to an App Service or Virtual Machine. For more information, see [Managed Identity Overview](../../active-directory/managed-identities-azure-resources/overview.md).
 
 In the example below, the name of your key vault is expanded to the key vault URI, in the format "https://\<your-key-vault-name\>.vault.azure.net". This example is using the ['DefaultAzureCredential()'](/java/api/com.azure.identity.defaultazurecredential) class, which allows to use the same code across different environments with different options to provide identity. For more information, see [Default Azure Credential Authentication](/java/api/overview/azure/identity-readme).
@@ -169,6 +186,7 @@ CertificateClient certificateClient = new CertificateClientBuilder()
 ```
 
 ### Save a secret
+
 Now that your application is authenticated, you can create a certificate in your key vault using the `certificateClient.beginCreateCertificate` method. This requires a name for the certificate and a certificate policy -- we've assigned the value "myCertificate" to the `certificateName` variable in this sample and use a default policy.
 
 Certificate creation is a long running operation, for which you can poll its progress or wait for it to complete.
@@ -186,6 +204,7 @@ KeyVaultCertificate createdCertificate = certificatePoller.getFinalResult();
 ```
 
 ### Retrieve a certificate
+
 You can now retrieve the previously created certificate with the `certificateClient.getCertificate` method.
 
 ```java
@@ -195,6 +214,7 @@ KeyVaultCertificate retrievedCertificate = certificateClient.getCertificate(cert
 You can now access the details of the retrieved certificate with operations like `retrievedCertificate.getName`, `retrievedCertificate.getProperties`, etc. As well as its contents `retrievedCertificate.getCer`.
 
 ### Delete a certificate
+
 Finally, let's delete the certificate from your key vault with the `certificateClient.beginDeleteCertificate` method, which is also a long running operation.
 
 ```java
@@ -203,6 +223,7 @@ deletionPoller.waitForCompletion();
 ```
 
 ## Clean up resources
+
 When no longer needed, you can use the Azure CLI or Azure PowerShell to remove your key vault and the corresponding resource group.
 
 ```azurecli
@@ -214,6 +235,7 @@ Remove-AzResourceGroup -Name "myResourceGroup"
 ```
 
 ## Sample code
+
 ```java
 package com.keyvault.certificates.quickstart;
 
@@ -236,16 +258,16 @@ public class App {
         System.out.printf("key vault name = %s and kv uri = %s \n", keyVaultName, keyVaultUri);
 
         CertificateClient certificateClient = new CertificateClientBuilder()
-                .vaultUrl(keyVaultUri)
-                .credential(new DefaultAzureCredentialBuilder().build())
-                .buildClient();
+            .vaultUrl(keyVaultUri)
+            .credential(new DefaultAzureCredentialBuilder().build())
+            .buildClient();
 
         String certificateName = "myCertificate";
 
         System.out.print("Creating a certificate in " + keyVaultName + " called '" + certificateName + " ... ");
 
         SyncPoller<CertificateOperation, KeyVaultCertificateWithPolicy> certificatePoller =
-                certificateClient.beginCreateCertificate(certificateName, CertificatePolicy.getDefault());
+            certificateClient.beginCreateCertificate(certificateName, CertificatePolicy.getDefault());
         certificatePoller.waitForCompletion();
 
         System.out.print("done.");
@@ -265,6 +287,7 @@ public class App {
 ```
 
 ## Next steps
+
 In this quickstart you created a key vault, created a certificate, retrieved it, and then deleted it. To learn more about Key Vault and how to integrate it with your applications, continue on to the articles below.
 
 - Read an [Overview of Azure Key Vault](../general/overview.md)

articles/key-vault/keys/quick-create-java.md

@@ -2,7 +2,7 @@
 title: Quickstart - Azure Key Vault Key client library for Java
 description: Provides a quickstart for the Azure Key Vault Keys client library for Java.
 author: msmbaldwin
-ms.custom: devx-track-java, devx-track-azurecli, devx-track-azurepowershell, mode-api
+ms.custom: devx-track-java, devx-track-azurecli, devx-track-azurepowershell, mode-api, passwordless-java
 ms.author: mbaldwin
 ms.date: 01/04/2023
 ms.service: key-vault
@@ -17,12 +17,13 @@ Get started with the Azure Key Vault Key client library for Java. Follow these s
 
 Additional resources:
 
-* [Source code](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/keyvault/azure-security-keyvault-keys)
-* [API reference documentation](https://azure.github.io/azure-sdk-for-java/keyvault.html)
-* [Product documentation](index.yml)
-* [Samples](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/keyvault/azure-security-keyvault-keys/src/samples/java/com/azure/security/keyvault/keys)
+- [Source code](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/keyvault/azure-security-keyvault-keys)
+- [API reference documentation](https://azure.github.io/azure-sdk-for-java/keyvault.html)
+- [Product documentation](index.yml)
+- [Samples](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/keyvault/azure-security-keyvault-keys/src/samples/java/com/azure/security/keyvault/keys)
 
 ## Prerequisites
+
 - An Azure subscription - [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - [Java Development Kit (JDK)](/java/azure/jdk/) version 8 or above
 - [Apache Maven](https://maven.apache.org)
@@ -31,22 +32,25 @@ Additional resources:
 This quickstart assumes you're running [Azure CLI](/cli/azure/install-azure-cli) and [Apache Maven](https://maven.apache.org) in a Linux terminal window.
 
 ## Setting up
+
 This quickstart is using the Azure Identity library with Azure CLI to authenticate user to Azure Services. Developers can also use Visual Studio or Visual Studio Code to authenticate their calls, for more information, see [Authenticate the client with Azure Identity client library](/java/api/overview/azure/identity-readme).
 
 ### Sign in to Azure
+
 1. Run the `login` command.
 
-    ```azurecli-interactive
-    az login
-    ```
+   ```azurecli-interactive
+   az login
+   ```
 
    If the CLI can open your default browser, it will do so and load an Azure sign-in page.
 
    Otherwise, open a browser page at [https://aka.ms/devicelogin](https://aka.ms/devicelogin) and enter the authorization code displayed in your terminal.
 
-2. Sign in with your account credentials in the browser.
+1. Sign in with your account credentials in the browser.
 
 ### Create a new Java console app
+
 In a console window, use the `mvn` command to create a new Java console app with the name `akv-keys-java`.
 
 ```console
@@ -88,6 +92,7 @@ cd akv-keys-java
 ```
 
 ### Install the package
+
 Open the *pom.xml* file in your text editor. Add the following dependency elements to the group of dependencies.
 
 ```xml
@@ -105,39 +110,49 @@ Open the *pom.xml* file in your text editor. Add the following dependency elemen
 ```
 
 ### Create a resource group and key vault
+
 [!INCLUDE [Create a resource group and key vault](../../../includes/key-vault-rg-kv-creation.md)]
 
 #### Grant access to your key vault
+
 Create an access policy for your key vault that grants key permissions to your user account.
 
 ```azurecli
 az keyvault set-policy --name <your-key-vault-name> --upn [email protected] --key-permissions delete get list create purge
 ```
 
 #### Set environment variables
+
 This application is using your key vault name as an environment variable called `KEY_VAULT_NAME`.
 
 Windows
+
 ```cmd
 set KEY_VAULT_NAME=<your-key-vault-name>
 ````
+
 Windows PowerShell
+
 ```powershell
 $Env:KEY_VAULT_NAME="<your-key-vault-name>"
 ```
 
 macOS or Linux
+
 ```cmd
 export KEY_VAULT_NAME=<your-key-vault-name>
 ```
 
 ## Object model
+
 The Azure Key Vault Key client library for Java allows you to manage keys. The [Code examples](#code-examples) section shows how to create a client, create a key, retrieve a key, and delete a key.
 
 The entire console app is supplied in [Sample code](#sample-code).
 
 ## Code examples
+
 ### Add directives
+
 Add the following directives to the top of your code:
 
 ```java
@@ -168,6 +183,7 @@ KeyClient keyClient = new KeyClientBuilder()
 ```
 
 ### Create a key
+
 Now that your application is authenticated, you can create a key in your key vault using the `keyClient.createKey` method. This requires a name for the key and a key type. We've assigned the value "myKey" to the `keyName` variable and use a an RSA `KeyType` in this sample.
 
 ```java
@@ -181,6 +197,7 @@ az keyvault key show --vault-name <your-unique-key-vault-name> --name myKey
 ```
 
 ### Retrieve a key
+
 You can now retrieve the previously created key with the `keyClient.getKey` method.
 
 ```java
@@ -190,6 +207,7 @@ KeyVaultKey retrievedKey = keyClient.getKey(keyName);
 You can now access the details of the retrieved key with operations like `retrievedKey.getProperties`, `retrievedKey.getKeyOperations`, etc.
 
 ### Delete a key
+
 Finally, let's delete the key from your key vault with the `keyClient.beginDeleteKey` method.
 
 Key deletion is a long running operation, for which you can poll its progress or wait for it to complete.
@@ -206,6 +224,7 @@ az keyvault key show --vault-name <your-unique-key-vault-name> --name myKey
 ```
 
 ## Clean up resources
+
 When no longer needed, you can use the Azure CLI or Azure PowerShell to remove your key vault and the corresponding resource group.
 
 ```azurecli
@@ -217,6 +236,7 @@ Remove-AzResourceGroup -Name "myResourceGroup"
 ```
 
 ## Sample code
+
 ```java
 package com.keyvault.keys.quickstart;
 
@@ -237,9 +257,9 @@ public class App {
         System.out.printf("key vault name = %s and key vault URI = %s \n", keyVaultName, keyVaultUri);
 
         KeyClient keyClient = new KeyClientBuilder()
-                .vaultUrl(keyVaultUri)
-                .credential(new DefaultAzureCredentialBuilder().build())
-                .buildClient();
+             .vaultUrl(keyVaultUri)
+             .credential(new DefaultAzureCredentialBuilder().build())
+             .buildClient();
 
         String keyName = "myKey";
 
@@ -264,6 +284,7 @@ public class App {
 ```
 
 ## Next steps
+
 In this quickstart, you created a key vault, created a key, retrieved it, and then deleted it. To learn more about Key Vault and how to integrate it with your applications, continue on to these articles.
 
 - Read an [Overview of Azure Key Vault](../general/overview.md)