대화형 맵 구성

대화형 맵 정보

GitHub Enterprise Server 인스턴스의 사용자가 GeoJSON 또는 TopoJSON 구문을 사용하여 대화형 맵을 생성하도록 허용할 수 있습니다. 대화형 맵 생성에 대한 자세한 내용은 "다이어그램 만들기" 항목을 참조하세요.

대화형 맵을 사용하도록 설정하려면 Azure Maps에 대한 인증 자격 증명을 제공해야 합니다.

필수 조건

• 인스턴스에 대한 대화형 맵을 구성하려면 Microsoft Entra ID의 테넌트에 대한 관리 액세스 권한이 있어야 합니다. 자세한 내용은 회사의 Microsoft 리소스 관리자에게 문의하거나 Microsoft Learn의 빠른 시작: Microsoft Entra ID에서 새 테넌트 만들기를 참조하세요..

• Entra ID에서 테넌트의 테넌트 ID를 알고 있어야 합니다. 자세한 내용은 Microsoft Learn의 Azure Portal에서 구독 및 테넌트 ID 가져오기를 참조하세요.

• 인스턴스가 https://login.microsoftonline.com에 액세스할 수 있어야 합니다.

Azure Maps에 대한 자격 증명 생성

Azure Maps에 대한 자격 증명을 생성하려면 Entra ID에서 테넌트에 대한 애플리케이션을 만들고, Azure Maps 계정에 애플리케이션 액세스를 제공하고, RBAC(역할 기반 액세스 제어)를 구성해야 합니다.

1. Entra ID 테넌트에 새 애플리케이션을 등록합니다. 자세한 내용은 Microsoft Learn의 빠른 시작: Microsoft ID 플랫폼을 사용하여 애플리케이션 등록을 참조하세요.

   • 지원되는 계정 유형을 지정할 때 이 조직 디렉터리 계정의 계정만을 선택합니다.

2. 클라이언트 암호 추가. 자세한 내용은 Microsoft Learn의 빠른 시작: Microsoft ID 플랫폼을 사용하여 애플리케이션 등록을 참조하세요.

3. GitHub Enterprise Server 인스턴스에서 인증을 구성할 때 참조할 수 있는 안전한 위치에 비밀 값을 저장합니다. 페이지를 나가면 Entra는 값을 표시하지 않습니다.

4. Azure Maps로 비밀에 대한 액세스를 구성합니다.

   1. Entra ID 테넌트에서 구성한 애플리케이션에 대한 세부 정보를 보는 동안 왼쪽 사이드바에서 API 권한을 클릭합니다.
   2. 권한 추가를 클릭합니다.
   3. Azure Maps를 클릭합니다.
   4. 위임된 권한을 선택합니다.
   5. "권한 선택"에서 "user_impersonation"을 선택합니다.
   6. 권한을 저장하려면 권한 추가를 클릭합니다.

5. Azure Maps 계정에 로그인합니다. 계정이 없는 경우 하나 만들면 됩니다. 자세한 내용은 Azure Maps 계정 웹 사이트를 참조하세요.

6. Azure Maps에 대한 RBAC를 구성합니다. 자세한 내용은 Microsoft Learn의 Azure Maps 인증과 Azure Portal을 사용하여 Azure 역할 할당을 참조하세요.

   • Entra ID 테넌트의 액세스 제어(IAM) 에서 "Azure Maps 데이터 읽기 권한자" 역할을 "사용자, 그룹 또는 서비스 주체"에 할당하고, 이 지침의 앞부분에서 만든 애플리케이션을 선택하고 양식을 작성해야 합니다.

대화형 맵 사용

Entra ID 테넌트에 애플리케이션을 만들고 Azure Maps 사용을 위한 비밀을 생성한 후 GitHub Enterprise Server 인스턴스에서 대화형 맵을 구성할 수 있습니다.

1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

4. 설정에서 사이드바의 프라이버시 탭을 클릭하세요.

5. 대화형 맵을 사용하도록 설정하려면 "GeoJSON 렌더링 사용"을 선택합니다.

6. CSRF(교차 사이트 요청 위조)를 방지하기 위해 비밀로 사용할 32자 문자열을 생성합니다. 예를 들어, 관리 셸에 액세스하고 GitHub Enterprise Server 인스턴스에서 openssl을 사용하여 문자열을 생성할 수 있습니다. 자세한 내용은 "관리 셸(SSH)에 액세스"을(를) 참조하세요.

   Shell

   openssl rand -hex 32
   

   다음 단계에서 참조할 수 있는 안전한 위치에 문자열을 저장합니다.

7. 제목 아래에 Azure Maps에 대한 인증 세부 정보를합니다.

   • 필요에 따라 렌더링된 맵의 스타일을 변경하려면 "기본 맵 ID"에서 사용하려는 스타일의 ID를 입력합니다.

   • 제목 아래에 인증 세부 정보를 입력하거나 붙여넣습니다.

     값	설명	자세한 정보
     Azure Map 클라이언트 ID	Azure Maps 계정의 클라이언트 ID	Microsoft Learn의 Azure Maps의 인증 관리
     Azure 앱 클라이언트 ID	Entra ID 테넌트에서 만든 애플리케이션의 애플리케이션(클라이언트) ID	Microsoft Learn의 리소스에 액세스할 수 있는 Microsoft Entra 애플리케이션 및 서비스 주체 만들기
     Azure 테넌트 ID	Entra ID의 테넌트에 대한 ID	"사전 요구 사항"
     Azure 앱 클라이언트 암호	EntraID 테넌트에서 애플리케이션에 대해 생성한 클라이언트 암호	"Azure Maps에 대한 자격 증명 생성"
     CSRF 비밀	CSRF 공격을 방지하기 위한 32자 문자열	이전 단계를 참조하세요.

8. "설정" 사이드바에서 설정 저장을 클릭합니다.

   참고: 관리 콘솔에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.

9. 구성 실행이 완료될 때까지 기다립니다.

대화형 맵 사용 중지

1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

4. 설정에서 사이드바의 프라이버시 탭을 클릭하세요.

5. 대화형 맵을 사용하지 않도록 설정하려면 "GeoJSON 렌더링 사용"을 선택 취소합니다.

6. "설정" 사이드바에서 설정 저장을 클릭합니다.

   참고: 관리 콘솔에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.

7. 구성 실행이 완료될 때까지 기다립니다.