Skip to content

Commit da1576b

Browse files
authored
Merge pull request #9170 from MicrosoftDocs/mints-moble-cert-updates
cert creation and signing updates
2 parents a68569f + d4d3949 commit da1576b

File tree

7 files changed

+26
-25
lines changed

7 files changed

+26
-25
lines changed

powerapps-docs/maker/common/wrap/code-sign-android.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Example:
5454

5555

5656

57-
- If preparing Keyvault, PATH_TO_KEYSTORE should have .pfx extension.
57+
- If preparing Key Vault, PATH_TO_KEYSTORE should have .pfx extension.
5858

5959
`keytool -genkey -alias powerappswrap -keyalg RSA -keystore powerappswrap.pfx -keysize 2048 -validity 10000`
6060

powerapps-docs/maker/common/wrap/code-sign-ios.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -175,7 +175,7 @@ To create a distribution certificate, create a new certificate signing request f
175175
1. If signing with enterprise certificate, open the **Distribution-exportOptions.plist** file. Open the folder with Xcode and change the value for the **method** field inside the file to **enterprise**.
176176

177177
> [!NOTE]
178-
> Enterprise signing is not supported with Keyvault signing.
178+
> Enterprise signing is not supported with Key Vault signing.
179179
180180
1. Open terminal, and change directory to the unzipped folder.
181181

powerapps-docs/maker/common/wrap/create-key-vault-for-code-signing.md

Lines changed: 18 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Create key vault for code signing
3-
description: Learn how to create Azure key vault for automated code signing of native mobile apps in wrap wizard.
2+
title: Create Key Vault for code signing
3+
description: Learn how to create Azure Key Vault for automated code signing of native mobile apps in wrap wizard.
44
author: makolomi
55
ms.topic: article
66
ms.custom: canvas
@@ -13,12 +13,12 @@ search.audienceType:
1313
contributors:
1414
- mkaur-msft
1515
---
16-
# Create Azure key vault for wrap in Power Apps
16+
# Create Azure Key Vault for wrap in Power Apps
1717

18-
In order to automatically, sign your Android or iOS mobile app package during [Step 2](wrap-how-to.md#step-2-target-platform) of the wrap wizard, it's necessary to have Azure Key Vault configured. Azure Key Vault is a cloud-based service designed to provide a secure storage solution for secrets, which can include certificates, passwords, keys, and other sensitive information. To learn more about Azure Key Vault, see [Introduction to Azure key vault](/azure/key-vault/general/overview).
18+
In order to automatically, sign your Android or iOS mobile app package during [Step 2](wrap-how-to.md#step-2-target-platform) of the wrap wizard, it's necessary to have Azure Key Vault configured. Azure Key Vault is a cloud-based service designed to provide a secure storage solution for secrets, which can include certificates, passwords, keys, and other sensitive information. To learn more about Azure Key Vault, see [Introduction to Azure Key Vault](/azure/key-vault/general/overview).
1919

2020

21-
In this article, you will learn how to use an existing Azure key vault or create a new [Azure portal](https://portal.azure.com).
21+
In this article, you will learn how to use an existing Azure Key Vault or create a new [Azure portal](https://portal.azure.com).
2222

2323
## Prerequisites
2424

@@ -28,15 +28,15 @@ In this article, you will learn how to use an existing Azure key vault or create
2828
- Create a [distribution certificate](code-sign-ios.md#create-the-distribution-certificate) or [ad-hoc Provisioning Profile](code-sign-ios.md#create-an-ios-provisioning-profile) or enterprise provisioning profile.
2929

3030

31-
## Create Azure key vault and configure KeyVault URI
31+
## Create Azure Key Vault and configure Key Vault URI
3232

3333
1. To create a new Azure service principal for the 1P Microsoft Entra application **4e1f8dc5-5a42-45ce-a096-700fa485ba20 (WrapKeyVaultAccessApp)**, sign in to your tenant as an admin. Then, run the following script in PowerShell:
3434

3535
`Connect-AzureAD -TenantId <your tenant ID>`<br>
3636
`New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"`
3737

3838

39-
2. Follow these steps to ensure that the Service Principal representing your app, such as Wrap KeyVault Access App, has the necessary access permissions, add a **Reader** role assignment to it in the **Access Control (IAM)** of your default subscription. This should also be present in the IAM of both the subscription and the Keyvault.
39+
2. Follow these steps to ensure that the Service Principal representing your app, such as Wrap Key Vault Access App, has the necessary access permissions, add a **Reader** role assignment to it in the **Access Control (IAM)** of your default subscription. This should also be present in the IAM of both the subscription and the Key Vault.
4040

4141
1. On the left select **Access control (IAM)** tab and then select **Add** > **Add role assignment**.
4242

@@ -45,26 +45,26 @@ In this article, you will learn how to use an existing Azure key vault or create
4545
> [!div class="mx-imgBorder"]
4646
> ![Select the Members tab.](media/how-to-v2/Add_members.png "Select the Members tab.")
4747
48-
4. On **Members** tab, select **Select member** and in the text box on the right enter **Wrap KeyVault Access App** and search for it.
48+
4. On **Members** tab, select **Select member** and in the text box on the right enter **Wrap Key Vault Access App** and search for it.
4949

5050
> [!div class="mx-imgBorder"]
51-
> ![Search for Wrap KeyVault Access App.](media/how-to-v2/Add_role_assignment.png "Search for Wrap KeyVault Access App.")
51+
> ![Search for Wrap Key Vault Access App.](media/how-to-v2/Add_role_assignment.png "Search for Wrap Key Vault Access App.")
5252
53-
5. Select **Wrap KeyVault Access App** and then select **Review + assign** to assign the **Reader** role.
53+
5. Select **Wrap Key Vault Access App** and then select **Review + assign** to assign the **Reader** role.
5454

5555
> [!div class="mx-imgBorder"]
5656
> ![Assign Reader role to Wrap KeyVault Access App.](media/how-to-v2/Add_role_for_wrap_signing.png "Assign Reader role to Wrap KeyVault Access App.")
5757
5858

59-
3. Create or access existing key vault. Make sure this key vault is located in the default subscription for your tenant. More information: [Create a key vault using the Azure portal](/azure/key-vault/general/quick-create-portal).
59+
3. Create or access existing Key Vault. Make sure this Key Vault is located in the default subscription for your tenant. More information: [Create a key vault using the Azure portal](/azure/key-vault/general/quick-create-portal).
6060

61-
4. Add access policies for the key vault.
61+
4. Add access policies for the Key Vault.
6262

6363
5. Choose one of the following options based on your device:
6464

6565
- **Android**
6666

67-
Generate the .pfx file and then proceed to upload it to the certificate section of the keyvault. More information: [Generate keys](code-sign-android.md#generate-keys)
67+
Generate the .pfx file and then proceed to upload it to the certificate section of the Key Vault. More information: [Generate keys](code-sign-android.md#generate-keys)
6868

6969
:::image type="content" source="media/wrap-canvas-app/wrap-1.png" alt-text="Create a cert for Android.":::
7070

@@ -73,16 +73,17 @@ In this article, you will learn how to use an existing Azure key vault or create
7373
7474
- **iOS**
7575
1. Select the .cer into Keychain Access app to install it. For more information, see [Create the distribution certificate](code-sign-ios.md#create-the-distribution-certificate).
76-
2. Right-click your certificate file to export the file as a .p12 file, select **Export**, and then select the file format .p12.
76+
2. Right-click your certificate file to export the file as a .p12 file, select **Export**, and then select the file format .p12.
77+
3. The iOS Certificate extension (.p12) should be renamed to **.pfx** as it is the accepted format by Key Vault
7778

7879
> [!NOTE]
79-
> When you upload to the keyvault, you'll need to provide the password that you set in previous step for the .p12 file.
80+
> When you upload to the Key Vault, you'll need to provide the password that you set in previous step for the .p12 file.
8081
8182
3. [Create the provisioning profile](code-sign-ios.md#create-an-ios-provisioning-profile) and run this command to encode it to base64:
8283
- Mac: base64 `-i example.mobileprovision`
8384
- Windows: `certutil -encode data.txt tmp.b64`
8485

85-
4. Upload the `base64` string obtained from the previous step to the Keyvault secret. Next, upload the .p12 file to Keyvault Certificate.
86+
4. Upload the `base64` string obtained from the previous step to the Key Vault secret. Next, upload the .p12 file to Key Vault Certificate.
8687

8788

8889
:::image type="content" source="media/wrap-canvas-app/wrap-2.png" alt-text="Create a cert for iOS.":::
@@ -102,4 +103,4 @@ For Troubleshooting issues, see [Troubleshoot issues with the wrap feature in Po
102103
- [Code sign for iOS](code-sign-ios.md)
103104
- [Code sign for Android](code-sign-android.md)
104105
- [Code sign for Google Play Store](https://developer.android.com/studio/publish/app-signing)
105-
- [Frequently asked questions for wrap](faq.yml)
106+
- [Frequently asked questions for wrap](faq.yml)

powerapps-docs/maker/common/wrap/faq.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ sections:
4141
- question: |
4242
How do I digitally sign my mobile app?
4343
answer: |
44-
You can automatically sign your mobile app package in **Step 2: Target Platforms** step in wrap wizard. You will need to [create and prepare your Azure key vault](create-key-vault-for-code-signing.md) to take advantage of automatic mobile app signing feature in wrap wizard. For information on how to code sign your app manually, see instructions here: [Android](code-sign-android.md), [iOS](code-sign-ios.md) and [Google Play Store](https://developer.android.com/studio/publish/app-signing).
44+
You can automatically sign your mobile app package in **Step 2: Target Platforms** step in wrap wizard. You will need to [create and prepare your Azure Key Vault](create-key-vault-for-code-signing.md) to take advantage of automatic mobile app signing feature in wrap wizard. For information on how to code sign your app manually, see instructions here: [Android](code-sign-android.md), [iOS](code-sign-ios.md) and [Google Play Store](https://developer.android.com/studio/publish/app-signing).
4545
4646
- question: |
4747
Can I use Xcode to digitally sign my mobile apps for iOS?
Loading

powerapps-docs/maker/common/wrap/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,5 +150,5 @@ Optional additional canvas apps that you're wrapping in the same build for mobil
150150
- [Code sign on iOS](code-sign-ios.md)
151151
- [Code sign on Android](code-sign-Android.md)
152152
- [Code sign for Google Play Store](https://developer.android.com/studio/publish/app-signing)
153-
- [Create your Azure key vault for automated code signing](create-key-vault-for-code-signing.md)
153+
- [Create your Azure Key Vault for automated code signing](create-key-vault-for-code-signing.md)
154154
- [Frequently Asked Questions](faq.yml)

powerapps-docs/maker/common/wrap/wrap-how-to.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.custom: canvas
77
ms.reviewer: mkaur
88
ms.date: 2/9/2023
99
ms.subservice: canvas-maker
10-
ms.author: makolomi
10+
ms.author: clromano
1111
search.audienceType:
1212
- maker
1313
contributors:
@@ -90,7 +90,7 @@ More information: [Add an app to a solution](../../canvas-apps/add-app-solution.
9090
2. Under **Target platforms(s)**, select all the mobile platforms that your end users use on their mobile devices.
9191

9292
3. Set the **Sign my app** toggle to **ON** to automatically code sign your mobile app, then select the **Azure Key Vault URI** from the list and click **Next**.
93-
If you don't have any entries in **Azure Key Vault URI** list, you need to create **Azure Key Vault** first. More information: [Create Azure key valut for wrap for Power Apps](create-key-vault-for-code-signing.md).
93+
If you don't have any entries in **Azure Key Vault URI** list, you need to create **Azure Key Vault** first. More information: [Create Azure Key Vault for wrap for Power Apps](create-key-vault-for-code-signing.md).
9494

9595
> [!div class="mx-imgBorder"]
9696
> ![Choose the apps which you want to wrap.](media/how-to-v2/select-target-platforms.png "Select target platforms")
@@ -258,5 +258,5 @@ You can automatically sign your mobile app package during wrap process in **Step
258258
- [Code sign for iOS](code-sign-ios.md)
259259
- [Code sign for Android](code-sign-android.md)
260260
- [Code sign for Google Play Store](https://developer.android.com/studio/publish/app-signing)
261-
- [Create your Azure key vault for automated code signing](create-key-vault-for-code-signing.md)
262-
- [Frequently asked questions for wrap](faq.yml)
261+
- [Create your Azure Key Vault for automated code signing](create-Key-Vault-for-code-signing.md)
262+
- [Frequently asked questions for wrap](faq.yml)

0 commit comments

Comments
 (0)