자체 Azure Static Web Apps 계정에 정적 사이트 배포

연결 시 제공되는 기능

자체 Azure Static Web Apps 계정을 연결하면 Zinn® 대시보드에서 고객님의 Azure Static Web Apps 계정으로 정적 사이트를 배포할 수 있습니다. 프로젝트와 청구 비용에 대한 소유권은 고객님께 있으며, Zinn®에서는 배포, 사용자 지정 도메인 및 DNS 레코드를 처리합니다.

시작하기 전에

Azure 구독, 사이트용 리소스 그룹, 그리고 코드가 포함된 연결된 GitHub, GitLab 또는 Bitbucket 계정이 필요합니다. Azure Static Web Apps는 저장소를 기반으로 빌드됩니다. Azure의 무료 요금제는 상업적 사용과 앱당 2개의 사용자 지정 도메인을 허용합니다.

1. Azure Static Web Apps에서 키 생성하기

Azure에서는 이를 서비스 주체라고 부릅니다. Microsoft Entra 관리 센터에서 Entra ID → 앱 등록 → 새 등록을 열고, 이름을 지정한 다음 등록합니다. 앱의 개요 페이지에서 애플리케이션(클라이언트) ID와 디렉터리(테넌트) ID를 복사합니다. 그런 다음 인증서 및 비밀 → 클라이언트 암호 → 새 클라이언트 암호를 열고, 유효 기간을 선택한 후 추가합니다. Azure에서는 이 값을 한 번만 표시하므로 클라이언트 암호 값을 즉시 복사해 두십시오.

Azure Portal에서 사용하려는 리소스 그룹을 연 다음, 액세스 제어(IAM) → 추가 → 역할 할당 추가로 이동합니다. 기여자 역할을 선택하고, 사용자, 그룹 또는 서비스 주체에 할당한 후, 이름으로 앱을 검색하여 검토 + 할당합니다. 리소스 그룹의 이름과 해당 리소스 그룹이 속한 구독 ID(Portal에서 구독 검색)를 메모해 둡니다.

2. 여기에 연결하기

대시보드에서 연동을 열고 계정 연결을 선택합니다. 그룹으로 정적 호스팅(Netlify, Vercel)을 선택하고 계정으로 Azure Static Web Apps를 선택한 후, 클라이언트 ID, 클라이언트 암호, 테넌트 ID, 구독 ID, 리소스 그룹을 입력하고 계정 연결을 누릅니다.

저장되기 전에 입력하신 내용을 테스트합니다. 작동하지 않는 키는 절대로 저장되지 않으며, 응답 메시지에 오류 원인이 표시됩니다. 작동하는 키는 당사의 비밀 저장소에 암호화되어 보관되며(데이터베이스에는 절대 저장되지 않음), 고객님을 포함하여 그 누구에게도 다시 표시되지 않습니다.

이후 진행 과정

• 정적 사이트를 생성하거나 이전할 때 이 계정이 배포 대상으로 나타납니다.

Azure Static Web Apps는 저장소에서 빌드되며 업로드된 빌드를 직접 수신할 수 없으므로, 사이트의 코드는 연결된 GitHub, GitLab 또는 Bitbucket 저장소에서 가져와야 합니다. 아직 연결하지 않으셨다면 먼저 연결해 주십시오.

• 당사에서 고객님의 계정에 서비스를 생성하고, 이를 저장소에 연결하며, 사용자 지정 도메인을 연결하고 배포를 트리거합니다. 도메인 페이지에는 Azure Static Web Apps에 필요한 모든 DNS 레코드가 표시됩니다.
• 사용량 및 요금 청구는 고객님의 계정으로 이루어지며, 고객님의 서비스 제공업체 대시보드에서 확인하실 수 있습니다.
• apex 도메인은 TXT 레코드로 확인되고 서브도메인은 CNAME으로 확인됩니다. 도메인 페이지에 고객님의 도메인에 필요한 항목이 표시됩니다.

연결되지 않는 경우

Azure에서 서비스 주체를 거부했습니다. 클라이언트 암호가 만료되었거나(선택하신 유효 기간에 따라 항상 만료됨), 해당 앱에 리소스 그룹에 대한 기여자 권한이 더 이상 없는 경우입니다. 두 메시지가 유사하게 표시되므로 새 암호를 생성하기 전에 역할 할당을 확인해 보십시오.

아무것도 찾을 수 없습니다. 구독 ID와 리소스 그룹이 역할을 할당한 대상이 맞는지, 그리고 테넌트 ID가 해당 앱이 등록된 디렉터리가 맞는지 확인하십시오.

키가 거부되었다고 표시됩니다. 거의 항상 다음 세 가지 중 하나입니다. 공백이나 줄 바꿈이 함께 복사되었거나, 키가 만료되었거나, 복사한 후 키가 취소 또는 재생성된 경우입니다. 새 키를 생성하여 다시 붙여넣으십시오.

연결은 되지만 나중에 문제가 발생합니다. 키 인증은 되었으나 해당 작업에 필요한 권한이 부족한 상태입니다. 위에 명시된 권한으로 새 키를 생성한 후 기존 연결을 해제하고 새 키를 연결하십시오.

연결 해제하기

연동을 열고 해당 계정을 찾은 다음 연결 해제를 누릅니다. 이렇게 하면 저장된 키가 즉시 삭제됩니다. 해당 키를 사용하던 모든 작업은 다음 작업 실행 시 중단되며, 해당 키에 의존하던 화면에는 알림 없이 실패하는 대신 해당 상태가 표시됩니다.

연결을 해제하더라도 이미 완료된 작업은 취소되지 않으며, 고객님의 계정에서 변경된 레코드, 배포 또는 설정은 그대로 유지됩니다. 키 자체가 유출되었다고 생각되시면 서비스 제공업체 측에서도 키를 취소하십시오. 연결 해제 시 당사에 저장된 사본만 삭제되며 제공업체 측의 키는 삭제되지 않습니다.