비주얼 스튜디오 커넥티드 서비스를 사용하여 웹 애플리케이션에 키 볼트 추가하기
이 자습서에서는 ASP.NET Core를 사용하든 모든 유형의 ASP.NET 프로젝트를 사용하든 관계없이 Visual Studio에서 웹 프로젝트의 암호를 관리하는 데 필요한 모든 것을 Azure Key Vault를 사용하여 쉽게 추가하는 방법을 알아봅니다. Visual Studio의 연결된 서비스 기능을 사용하면 Visual Studio에서 Azure의 Key Vault에 연결하는 데 필요한 모든 NuGet 패키지와 구성 설정을 자동으로 추가하도록 할 수 있습니다.
필수 조건
- Azure 계정. Azure 계정: Azure 계정이 없는 경우 평가판을 등록하거나 Visual Studio 구독자 혜택을 활성화할 수 있습니다.
- Visual Studio 2019 버전 16.3 이상을 다운로드합니다.
프로젝트에 키 볼트 지원 추가
시작하기 전에 Visual Studio에 로그인했는지 확인하세요. Azure 구독에 사용하는 계정과 동일한 계정으로 로그인합니다. 그런 다음, ASP.NET 4.7.1 이상, 또는 ASP.NET Core 웹 프로젝트를 열고 다음 단계를 수행합니다. 표시된 단계는 Visual Studio 2022 버전 17.4용입니다. 다른 버전의 Visual Studio에서는 흐름이 약간 다를 수 있습니다.
솔루션 탐색기에서, 마우스 오른쪽 버튼으로 Key Vault 지원을 추가할 프로젝트를 클릭한 다음, 추가>연결된 서비스를 선택하거나, 연결된 서비스 노드를 마우스 오른쪽 버튼으로 클릭하고 추가를 선택합니다.
연결된 서비스 노드를 확인할 수 없는 경우, 프로젝트>연결된 서비스>추가를 선택합니다.
서비스 종속성에서 + 아이콘을 선택합니다. 프로젝트에 추가할 수 있는 서비스가 표시된 연결된 서비스 페이지가 나타납니다.
사용 가능한 서비스 메뉴에서 Azure Key Vault를 선택하고 다음을 클릭합니다.
사용을 희망하는 구독을 선택한 다음, 사용하려는 Key Vault를 보유하고 있는 경우 이를 선택하고 다음을 클릭합니다.
기존 Key Vault가 없거나 기존 Key Vault와 다른 권한으로 설정할 수 있는 Key Vault가 필요한 경우 새 Key Vault 만들기를 클릭합니다. 리소스 그룹, 위치 및 SKU를 제공하라는 메시지가 표시됩니다.
Key Vault 구성 화면에서 Key Vault URI를 참조하는 환경 변수의 이름을 변경할 수 있습니다. 연결 문자열 여기에 저장되지 않고 키 자격 증명 모음에 저장됩니다.
참고 항목
보안을 강화하기 위해 Visual Studio 17.12 이상에서 이 단계에서는 연결 설정 이름을 만듭니다. 이전 버전에서는 연결 문자열 만듭니다. 로컬에 저장된 연결 문자열은 실수로 노출되는 경우 보안 위험을 초래할 수 있습니다.
변경 내용에 대한 요약이 표시될 때까지 다음을 클릭한 다음 마침을 클릭합니다.
시작하기 전에 Visual Studio에 로그인했는지 확인하세요. Azure 구독에 사용하는 계정과 동일한 계정으로 로그인합니다. 그런 다음, ASP.NET 4.7.1 이상, 또는 ASP.NET Core 웹 프로젝트를 열고 다음 단계를 수행합니다.
솔루션 탐색기에서, 마우스 오른쪽 버튼으로 Key Vault 지원을 추가할 프로젝트를 클릭한 다음, 추가>연결된 서비스를 선택하거나, 연결된 서비스 노드를 마우스 오른쪽 버튼으로 클릭하고 추가를 선택합니다.
연결된 서비스 노드를 확인할 수 없는 경우, 프로젝트>연결된 서비스>추가를 선택합니다.
서비스 종속성에서 + 아이콘을 선택합니다. 프로젝트에 추가할 수 있는 서비스가 표시된 연결된 서비스 페이지가 나타납니다.
사용 가능한 서비스 메뉴에서 Azure Key Vault를 선택하고 다음을 클릭합니다.
사용을 희망하는 구독을 선택한 다음, 사용하려는 Key Vault를 보유하고 있는 경우 이를 선택하고 다음을 클릭합니다.
기존 Key Vault가 없는 경우 새 Key Vault 만들기를 클릭합니다. 리소스 그룹, 위치 및 SKU를 제공하라는 메시지가 표시됩니다.
Key Vault 구성 화면에서 Key Vault URI를 참조하는 환경 변수의 이름을 변경할 수 있습니다. 연결 문자열 여기에 저장되지 않고 키 자격 증명 모음에 저장됩니다.
다음을 클릭하여 변경 내용 요약을 검토한 다음, 마침을 클릭합니다.
이제 Key Vault에 연결이 설정되고 코드에서 암호에 액세스할 수 있습니다. 새 Key Vault를 방금 만든 경우 코드에서 참조할 수 있는 비밀을 만들어 테스트합니다. Azure Portal, PowerShell 또는 Azure CLI를 사용하여 비밀을 만들 수 있습니다.
.NET용 Azure Key Vault 비밀 클라이언트 라이브러리 - 코드 예제에서 비밀로 작업하는 코드 예제를 참조하세요.
키 자격 증명 모음에 대한 액세스 구성
Visual Studio 2022 버전 17.11 이전 버전에서 이 자습서를 진행한 경우 Key Vault 권한은 사용자 고유의 Azure 구독으로 실행되도록 설정되지만 프로덕션 시나리오에는 바람직하지 않을 수 있습니다. 관리 ID를 만들어 앱에 대한 Key Vault 액세스를 관리할 수 있습니다. 자세한 내용은 Key Vault에서 인증 받는 방법 및 Key Vault 액세스 정책 할당을 참조하세요.
Key Vault가 Visual Studio에 로그인한 계정과 다른 Microsoft 계정으로 실행되는 경우(예: Key Vault는 회사 계정에서 실행되지만 Visual Studio는 개인 계정을 사용하고 있는 경우) Program.cs 파일에서 Visual Studio가 Key Vault에 액세스할 수 없다는 오류가 발생합니다. 이 문제를 해결하려면 Azure Portal로 이동하여 키 자격 증명 모음을 열고 액세스 제어(IAM)를 선택하여 권한을 설정합니다. Azure RBAC(역할 기반 액세스 제어)를 사용하여 Key Vault 키, 인증서 및 비밀에 대한 액세스 제공을 참조하세요.
참고 항목
이전 키 자격 증명 모음은 레거시 액세스 정책 모델을 사용할 수 있습니다. Azure RBAC를 사용하도록 이전 키 자격 증명 모음을 마이그레이션하는 것이 좋습니다. Azure RBAC(역할 기반 액세스 제어)와 액세스 정책 비교 참조하세요.
다음 단계
Key Vault 개발자 가이드를 확인하여 Key Vault 개발에 대해 자세히 알아봅니다.
Azure Key Vault에서 ASP.NET Core 앱에 대한 구성을 저장하는 것을 원할 경우 ASP.NET Core Azure Key Vault 구성 공급자를 참조하세요.