네이티브 인증을 사용하여 샘플 macOS 앱에서 사용자 로그인

적용 대상: 외부 테넌트(자세한 정보)

이 가이드에서는 Microsoft Entra 외부 ID를 사용하여 등록 및 로그인 시나리오를 보여 주는 macOS 샘플 애플리케이션을 실행하는 방법을 보여 줍니다.

이 문서에서는 다음 방법을 알아봅니다.

• 공용 클라이언트 및 네이티브 인증 흐름을 사용하도록 설정합니다.
• 사용자 고유의 외부 테넌트 세부 정보를 사용하도록 샘플 네이티브 macOS 애플리케이션을 업데이트합니다.
• 샘플 네이티브 macOS 애플리케이션을 실행하고 테스트합니다.

필수 조건

• 활성 구독이 있는 Azure 계정. 계정이 아직 없는 경우 무료로 계정을 만듭니다.

• 이 Azure 계정에는 애플리케이션을 관리할 수 있는 권한이 있어야 합니다. 다음 Microsoft Entra 역할에는 필요한 권한이 포함됩니다.

  • 애플리케이션 관리자
  • 애플리케이션 개발자

• 외부 테넌트입니다. 외부 테넌트가 없는 경우, Microsoft Entra 관리 센터에서 새 외부 테넌트를 만든 후 .

• 아직 등록하지 않았다면 Microsoft Entra 관리 센터에 응용 프로그램을 등록합니다. 다음을 수행해야 합니다.

  • 나중에 사용할 수 있는 애플리케이션(클라이언트) ID 및 디렉터리(테넌트) ID 를 기록합니다.
  • 애플리케이션에 관리자 동의를 부여 합니다.

• 아직 수행하지 않은 경우 Microsoft Entra 관리 센터에서 사용자 흐름을 만듭니다.

• 앱 등록을 사용자 흐름과 연결

• 엑스코드

공용 클라이언트 및 네이티브 인증 흐름 사용

이 앱이 공용 클라이언트이고 네이티브 인증을 사용할 수 있도록 지정하려면 공용 클라이언트 및 네이티브 인증 흐름을 사용하도록 설정합니다.

1. 앱 등록 페이지에서 공용 클라이언트 및 네이티브 인증 흐름을 사용하도록 설정할 앱 등록을 선택합니다.
2. 관리에서 인증을 선택합니다.
3. 고급 설정에서 공용 클라이언트 흐름을 허용합니다.
   1. 다음 모바일 및 데스크톱 흐름을 사용하도록예선택합니다.
   2. 네이티브 인증사용하도록 설정하려면 예선택합니다.
4. 저장 단추를 선택합니다.

샘플 macOS 애플리케이션 복제

1. 터미널을 열고 코드를 유지하려는 디렉터리로 이동합니다.

2. 다음 명령을 실행하여 GitHub에서 macOS 애플리케이션을 복제합니다.

   git clone https://github.com/Azure-Samples/ms-identity-ciam-native-auth-macos-sample.git
   

3. 리포지토리가 복제된 디렉터리로 이동합니다.

   cd ms-identity-ciam-native-auth-macos-sample
   

샘플 macOS 애플리케이션 구성

1. Xcode에서 NativeAuthSampleAppMacOS.xcodeproj 프로젝트를 엽니다.

2. NativeAuthSampleAppMacOS/Configuration.swift 파일을 엽니다.

3. 자리 표시자 찾기:

   • Enter_the_Application_Id_Here을 이전에 등록한 앱의 애플리케이션(클라이언트) ID 로 바꿉니다.
   • Enter_the_Tenant_Subdomain_Here를 디렉터리(테넌트) 하위 도메인으로 바꿉니다. 예를 들어 테넌트 주 도메인이 contoso.onmicrosoft.com경우 contoso를 사용합니다. 테넌트 하위 도메인이 없는 경우 테넌트 세부 정보를읽는 방법을 배워보세요.

샘플 macOS 애플리케이션 실행 및 테스트

코드를 빌드하고 실행하려면 Xcode의 제품 메뉴에서 실행을 선택합니다. 빌드에 성공하면 Xcode가 시뮬레이터에서 샘플 앱을 시작합니다.

이 가이드에서는 전자 메일 및 암호 사용을 테스트합니다. 유효한 전자 메일 주소와 암호를 입력하고 등록을 선택하고 코드 제출 화면을 시작합니다.

이전 화면에서 전자 메일 주소를 입력하면 애플리케이션에서 확인 코드를 보냅니다. 받은 코드를 제출하면 애플리케이션에서 이전 화면으로 돌아가 자동으로 로그인합니다.

다음 단계

• 자습서: 네이티브 인증을 위한 iOS/macOS 앱 준비하기.