Azure Maps AzureAD 샘플

페이지_유형	언어	제품	설명	URLFragment
견본	csharp 자바스크립트	하늘빛 하늘빛 지도 aspnetcore 하늘색 광고	Azure Active Directory를 Azure Maps와 통합하는 방법을 보여주는 샘플 컬렉션입니다.	AzureMapsAAD샘플

Azure Maps 및 Azure Active Directory 샘플

이는 AspNetCore C#을 사용하여 Azure Maps에 대한 Azure AD 인증을 빠르게 시작하는 4가지 샘플입니다. 각 샘플은 Azure AD 및 Azure RBAC(역할 기반 액세스 제어)에서 지원하는 애플리케이션 요구 사항에 따라 다양한 인증 프로토콜을 사용합니다.

내용물

저장소의 파일 내용을 간략하게 설명합니다. 이는 사용자가 코드베이스, 빌드 구성 및 관련 자산을 탐색하는 데 도움이 됩니다.

파일/폴더	설명
src/ImplicitGrant	서버 구성 요소 없이 사용자 인증을 표시하는 데 사용되는 샘플입니다.
src/OpenIdConnect	보안 웹 애플리케이션을 위해 Microsoft가 권장하는 프로토콜을 사용하는 샘플
src/ClientGrant	사용자 상호 작용 없이 애플리케이션 인증을 보여주는 샘플입니다.
.gitignore	커밋 시 무시할 항목을 정의합니다.
CONTRIBUTING.md	샘플 기여에 대한 지침.
README.md	시작 읽어보기.
LICENSE	샘플에 대한 라이센스입니다.

전제조건

이 샘플을 다운로드하기 전에

• ASP.NET 및 웹 개발 워크로드가 포함된 Visual Studio 2019 또는 Visual Studio Code.
• Azure 구독이 필요하며 필요한 경우 무료 계정에 등록하세요.
• Azure 구독과 연결된 Azure Active Directory 용 무료 SKU .

설정

Azure Active Directory에서 새 애플리케이션 등록을 만듭니다.

• 이 애플리케이션 등록은 웹 애플리케이션을 나타냅니다.
• 각 특정 샘플은 다양한 인증 프로토콜에 필요한 단계를 설명합니다.
• 이 샘플 저장소를 위해 동일한 애플리케이션 등록을 사용할 수 있습니다.
• 프로덕션의 경우 각 웹 애플리케이션에 대해 별도의 애플리케이션 등록을 권장합니다. 또한 Azure Maps에 대한 비대화형 인증을 위해 Azure 관리 ID를 사용하는 것이 좋습니다. 이를 통해 자격 증명 관리 비용이 절약됩니다.
• 표시 이름의 경우 이름을 "WebApp"으로 지정하고 리디렉션 URI를 비워 두고 개별 샘플 README.md 따를 수 있습니다.

Azure Portal에서 Azure Maps 계정을 만듭니다.

• 새 리소스 만들기에서 "Azure Maps"를 검색하고 포털을 따라 새 계정을 만듭니다.
• 계정이 생성되면 Azure Maps 클라이언트 ID를 검색하고 실행하려는 특정 샘플을 위해 보관하세요.
• 이 값은 모든 HTTP 요청과 함께 x-ms-client-id에서 사용되어야 합니다.
• SDK를 사용하는 경우 인증 옵션(JS)에 추가하세요.

샘플 실행

• 웹 애플리케이션 샘플 실행은 AspNetCore MVC v2.2 문서를 기반으로 합니다.
• 모든 개별 샘플 README.md가 구성되면 디버그(F5 키)가 애플리케이션을 빌드하고 시작해야 합니다.
• HTTPS가 구성된 상태에서 웹 애플리케이션을 실행해야 합니다.
• IIS 또는 AspNetCore를 통해 HTTPS 인증서를 개발하라는 메시지가 표시되면 인증서를 신뢰하라는 메시지를 수락합니다.

주요 개념

• Azure Maps 웹 SDK를 사용하면 Azure AD 액세스 토큰에 대한 두 가지 접근 방식이 지원됩니다.
• AspNetCore MVC와 같은 서버 구성 요소를 애플리케이션에 사용할 수 있는 경우 OpenID Connect를 권장합니다.
• 서버 구성 요소가 없는 경우 사용자 대화형 로그인 환경에 대해 암시적 권한 부여를 사용해야 합니다. 그러나 대화형 로그인이 없는 경우 액세스 토큰을 검색하고 Azure Maps 웹 SDK에 제공하려면 일부 서버 구성 요소가 있어야 합니다.
• Azure 서비스 인증 라이브러리를 사용하면 자격 증명 관리의 복잡성과 비용을 줄이고 Azure Virtual Machines 또는 Azure App Service와 같은 호스팅된 플랫폼에서 Azure 관리 ID를 사용할 수 있습니다.

기여

이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여는 귀하가 귀하의 기여를 사용할 수 있는 권리를 갖고 있으며 실제로 그렇게 하고 있음을 선언하는 기여자 라이센스 계약(CLA)에 동의해야 합니다. 자세한 내용을 보려면 https://cla.opensource.microsoft.com을 방문하세요.

끌어오기 요청을 제출하면 CLA 봇이 자동으로 CLA 제공이 필요한지 여부를 결정하고 PR을 적절하게 장식합니다(예: 상태 확인, 댓글). 봇이 제공하는 지침을 따르기만 하면 됩니다. CLA를 사용하여 모든 저장소에서 이 작업을 한 번만 수행하면 됩니다.

이 프로젝트는 Microsoft 오픈 소스 행동 강령을 채택했습니다. 자세한 내용은 행동 강령 FAQ를 참조하거나 추가 질문이나 의견이 있는 경우 [email protected]으로 문의하세요.