Power Apps에서 래핑 기능의 문제 해결
이 문서는 Microsoft Power Apps의 래핑 기능과 관련된 가장 일반적인 문제를 해결하는 데 도움이 됩니다.
문제 1 - 빌드 래핑 실패
래핑 빌드가 실패하는 경우 다음 단계를 수행하여 문제를 해결할 수 있습니다.
1단계: 이미지가 PNG 형식인지 확인
래핑에 사용하는 이미지가 PNG 형식인지 확인합니다. 래핑에서 PNG 이외의 형식으로 이미지를 사용하면 빌드가 실패합니다. 이미지 변환기를 사용하여 이미지를 .png 파일로 저장하거나 원본 이미지 파일이 PNG 형식인지 확인합니다.
Important
이미지 파일 확장자를 .jpeg 또는 다른 형식에서 .png 수동으로 변경해도 이미지가 PNG 형식으로 자동으로 다시 포맷되지는 않습니다.
2단계: App Center가 올바르게 구성되었는지 확인
App Center 링크는 독립 실행형 앱이 아닌 조직 내에서 앱으로 만들어야 합니다. 다음 스크린샷은 래핑 마법사에서 새 조직을 만드는 방법을 보여줍니다.
래핑 마법사에서 새 위치를 자동으로 만드는 방법에 대한 자세한 내용은 5단계: "마법사 를 사용하여 iOS 및 Android용 네이티브 모바일 앱 만들기" 섹션의 출력 관리를 참조하세요.
3단계: 키 자격 증명 모음 구성이 올바른지 확인
Azure 서비스 주체가 생성되고 서비스 주체 역할이 올바르게 추가되었는지 확인합니다. 자세한 내용은 마법사를 사용하여 iOS 및 Android용 네이티브 모바일 앱 만들기의 1단계와 2단계를 참조하세요.
키 자격 증명 모음에 iOS, Android 또는 둘 다에 필요한 모든 인증서, 비밀 및 태그가 포함되어 있는지 확인합니다.
- iOS: 태그 2개, 인증서 1개, 비밀 1개
- Android: 태그 1개 및 인증서 1개
자세한 내용은 Power Apps에서 래핑을 위한 Azure Key Vault 만들기를 참조 하세요.
4단계: 모든 적절한 구성이 있는 경우 다시 시도
래핑 프로젝트에 적절한 구성이 모두 있는지 확인한 후에도 래핑 빌드가 여전히 실패하는 경우 이 문서의 래핑 섹션에서 기타 문제를 참조하세요.
문제 2 - 내 앱에 대해 래핑 단추가 비활성화됨
편집 권한이 있는 앱만 래핑할 수 있습니다. 래핑하려는 앱에 대한 편집 권한이 있는지 확인하고 다시 시도합니다.
문제 3 - 프로젝트를 저장하거나 래핑 빌드를 트리거할 수 없음
이 문제를 해결하려면 다음을 수행할 수 있습니다.
- 최신 래핑 솔루션 버전으로 업데이트하고 다시 시도합니다.
- 저장 또는 빌드 제출을 차단하는 UI 유효성 검사 오류가 없는지 확인합니다.
문제 4 - 래핑된 모바일 앱을 디바이스에 설치할 수 없습니다.
출력된 애플리케이션에 서명했는지 확인합니다. 키 자격 증명 모음을 구성하고 빌드 트리거 시간에 제공하거나 수동으로 서명하여 서명할 수 있습니다. 코드 서명에 대한 자세한 내용은 다음을 참조하세요.
모바일 디바이스가 이러한 최소 요구 사항을 충족하는지 확인합니다.
문제 5 - 래핑된 모바일 앱에 로그인할 수 없거나 데이터를 볼 수 없습니다.
래핑된 모바일 앱에 로그인할 수 없는 경우 다음을 확인합니다.
Microsoft Entra 앱이 제대로 구성되었습니다.
앱에 대한 모든 API 권한이 올바르게 추가되었습니다. 앱에 대한 API 권한을 보고 구성하는 방법에 대한 자세한 내용은 다음 스크린샷 및 API 권한 구성을 참조하세요.
스크립트가
Add-AdminAllowedThirdPartyApps성공적으로 실행되었습니다. 자세한 내용은 사용자 환경에서 등록된 앱 허용을 참조하세요.Microsoft Entra 앱 유형이 다중 테넌트입니다. Microsoft Entra 앱의 인증 탭에서 지원되는 계정 유형은 모든 조직 디렉터리의 계정이어야 합니다(모든 Microsoft Entra 디렉터리 - 다중 테넌트).
iOS 및 Android용으로 적절한 리디렉션 URI가 만들어졌습니다. Android의 경우 해시가 올바르게 제공되었는지 확인합니다. 리디렉션 URI를 구성하는 방법에 대한 자세한 내용은 플랫폼 설정 구성을 참조 하세요.
문제 6 - Power Apps에 대한 래핑의 Azure Key Vault 오류
다음 Azure Key Vault 오류는 Power Apps에 대한 래핑에 표시될 수 있으며 수정할 수 있습니다.
오류 코드 1000118
| 오류 코드 | 설명 |
|---|---|
| 1000118 | 기본 구독을 찾을 수 없거나 액세스 권한이 없습니다. |
참고 항목
Azure AD와 MSOnline PowerShell 모듈은 2024년 3월 30일부터 더 이상 사용되지 않습니다. 자세히 알아보려면 사용 중단 업데이트를 참조하세요. 이 날짜 이후에는 이러한 모듈에 대한 지원이 Microsoft Graph PowerShell SDK 및 보안 수정 사항에 대한 마이그레이션 지원으로 제한됩니다. 사용되지 않는 모듈은 2025년 3월 30일까지 계속 작동합니다.
Microsoft Graph PowerShell로 마이그레이션하여 Microsoft Entra ID(이전의 Azure AD)와 상호 작용하는 것이 좋습니다. 일반적인 마이그레이션 관련 질문은 마이그레이션 FAQ를 참조하세요. 참고 항목: MSOnline 버전 1.0.x는 2024년 6월 30일 이후 중단될 수 있습니다.
Azure Key Vault가 테넌트의 기본 구독에 있는지 확인합니다.
관리자 권한으로 PowerShell에서 다음 명령을 실행합니다.
Connect-AzureAD -TenantId <your tenant ID>New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"Azure Portal에서 기본 구독으로 이동합니다. IAM(액세스 제어) 페이지에서 앱을 나타내는 서비스 주체에 읽기 권한자 역할 할당을 추가합니다(예: KeyVault Access 앱 래핑). 구독의 IAM 및 Keyvault의 IAM에 있는지 확인합니다. 실행할 단계는 다음과 같습니다.
액세스 제어(IAM) 탭으로 이동하고 추가 메뉴 단추 아래에서 역할 할당 추가 옵션을 선택합니다.
작업 함수 역할 탭을 선택하고 읽기 권한자 역할이 선택되어 있는지 확인합니다. 그런 다음, 위쪽 메뉴에서 구성원 탭을 선택합니다.
멤버 탭에서 KeyVault 액세스 앱 래핑을 검색 합니다.
KeyVault 액세스 앱 래핑을 선택한 다음, 탭 아래쪽에서 검토 + 할당 단추를 선택하여 읽기 권한자 역할을 할당합니다.
오류 코드 1000119
| 오류 코드 | 설명 |
|---|---|
| 1000119 | Keyvault가 없거나 Keyvault에 액세스 권한이 없습니다. |
Azure Key Vault가 테넌트의 기본 구독에 있는지 확인합니다.
키 자격 증명 모음을 만들 때 자격 증명 모음 액세스 정책 옵션이 선택되어 있는지 확인합니다.
관리자 권한으로 PowerShell에서 다음 명령을 실행합니다.
Connect-AzureAD -TenantId <your tenant ID>New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"Azure Portal에서 기본 구독으로 이동합니다. IAM(액세스 제어) 페이지에서 앱을 나타내는 서비스 주체에 읽기 권한자 역할 할당을 추가합니다(예: KeyVault Access 앱 래핑). 구독의 IAM 및 Keyvault의 IAM에 있는지 확인합니다. 실행할 단계는 다음과 같습니다.
액세스 제어(IAM) 탭으로 이동하고 추가 메뉴 단추 아래에서 역할 할당 추가 옵션을 선택합니다.
작업 함수 역할 탭을 선택하고 읽기 권한자 역할이 선택되어 있는지 확인합니다. 그런 다음, 위쪽 메뉴에서 구성원 탭을 선택합니다.
멤버 탭에서 KeyVault 액세스 앱 래핑을 검색 합니다.
KeyVault 액세스 앱 래핑을 선택한 다음, 탭 아래쪽에서 검토 + 할당 단추를 선택하여 읽기 권한자 역할을 할당합니다.
Azure Key Vault에 액세스 정책을 추가합니다.
오류 코드 1000120
| 오류 코드 | 설명 |
|---|---|
| 1000120 | 키 자격 증명 모음에서 조직 ID 태그를 찾을 수 없음 |
Power Platform 관리 센터로 이동하여 환경을 선택한 다음 래핑 프로젝트가 있는 환경을 선택합니다.
조직 ID를 복사합니다.
Azure Portal의 키 자격 증명 모음에서 태그로 이동하여 조직 ID라는 새 태그를 만들고 이 태그에 조직 ID를 추가합니다.
오류 코드 1000121
| 오류 코드 | 설명 |
|---|---|
| 1000121 | Android 키 저장소가 잘못되었습니다. 누락된 태그 및/또는 인증서 |
Android 인증서를 가져옵니다.
인증서에 대한 새 태그를 추가합니다.
태그 이름은 래핑 프로젝트에서 사용한 번들 ID를 기반으로 해야 합니다. 예를 들어 래핑된 앱의 번들 ID가 com.testApp.wrap인 경우 새 태그 이름은 com.testApp.wrap.keystore여야 합니다.
태그 값은 이전 단계에서 인증서 파일을 업로드할 때 인증서에 대해 선택한 이름과 일치해야 합니다. 예를 들어 인증서 이름이 AndroidWrapCertificate이면 태그 값의 값도 AndroidWrapCertificate여야 합니다.
오류 코드 1000122
| 오류 코드 | 설명 |
|---|---|
| 1000122 | iOS 인증서가 잘못되었습니다. |
iOS 인증서를 가져옵니다.
인증서에 대한 새 태그를 추가합니다.
태그 이름은 래핑 프로젝트에서 사용한 번들 ID를 기반으로 해야 합니다. 예를 들어 래핑된 앱의 번들 ID가 com.testApp.wrap인 경우 새 태그 이름은 com.testApp.wrap.cert여야 합니다.
태그 값은 이전 단계에서 인증서 파일을 업로드할 때 인증서에 대해 선택한 이름과 일치해야 합니다. 예를 들어 인증서 이름이 iOSCertificate1이면 태그 값의 값도 iOSCertificate1이어야 합니다.
오류 코드 1000123
| 오류 코드 | 설명 |
|---|---|
| 1000123 | iOS 프로필이 잘못되었습니다. |
프로비전 프로필을 비밀로 가져옵니다.
프로비전 프로필에 대한 새 태그를 추가합니다.
태그 이름은 래핑 프로젝트에서 사용한 번들 ID를 기반으로 해야 합니다. 예를 들어 래핑된 앱의 번들 ID가 com.testApp.wrap인 경우 새 태그 이름은 com.testApp.wrap.profile이어야 합니다.
태그 값은 이전 단계에서 povisioning 프로필을 업로드할 때 비밀에 대해 선택한 이름과 일치해야 합니다. 예를 들어 비밀 이름이 iOSProvisioningProfileSecret인 경우 태그 값도 iOSProvisioningProfileSecret이어야 합니다.
Power Apps에 대한 래핑의 기타 문제
다른 모든 문제 또는 이러한 단계를 수행한 후에도 문제가 지속되는 경우 이 문서의 뒷부분에 있는 다음 단계를 참조하여 지원 요청을 통해 문제를 보고합니다. 재현 비디오, 스크린샷 또는 둘 다와 다음과 같은 방법으로 가져올 수 있는 세션 ID를 제공해야 합니다.
- 로그인 화면에서 오른쪽 아래 모서리로 이동하여 기어 아이콘을 선택한 다음 세션 세부 정보를 선택합니다.
- 앱을 연 후 화면을 길게 누른 다음 세션 세부 정보를 선택합니다.
다음 단계
이 문서에 문제가 나열되지 않은 경우 더 많은 지원 리소스를 검색하거나 Microsoft 지원에 문의할 수 있습니다. 자세한 내용은 도움말 + 지원 받기를 참조하세요.