SharePoint Server용 앱의 환경 구성

아티클
03/08/2023

적용 대상: yes-img-13 2013 yes-img-16 2016 yes-img-19 2019 yes-img-se Subscription Edition no-img-sop SharePoint in Microsoft 365

사용자가 자신의 사이트에 SharePoint용 앱을 설치하고 사용할 수 있도록 하려면 해당 앱을 지원하도록 환경을 구성합니다. 이 문서에서는 앱을 지원하도록 환경을 구성하는 방법을 설명합니다. 이 문서의 구성 설정에 사용할 값을 확인하고 옵션을 검토하려면 SharePoint Server용 앱 계획 문서를 참조하세요.

Microsoft 365에서 SharePoint용 앱 카탈로그를 사용하여 앱을 관리하는 방법을 알아봅니다.

시작하기 전에

앱의 도메인 이름 공급자(예: ContosoApps.com)에서 도메인 이름을 구매합니다.
이 문서의 단계를 수행할 팜 관리자 그룹의 구성원인지 확인합니다. 일부 단계의 경우에는 도메인 관리자 권한도 필요합니다.
다중 테넌트 환경인 경우 Microsoft PowerShell을 사용하여 몇 가지 단계를 수행해야 합니다. Windows PowerShell을 사용하여 SharePoint Server 관리 권한이 있는지 확인합니다.

DNS의 도메인 이름 구성

DNS(Domain Name Services)의 새 도메인이 앱을 호스트하도록 구성해야 합니다. 보안을 강화하려면 도메인 이름이 SharePoint Server 사이트를 호스트하는 도메인의 하위 도메인이 아니어야 합니다. 예를 들어 SharePoint Server 사이트가 Contoso.com에 있으면 도메인 이름으로 App.Contoso.com 대신 ContosoApps.com을 고려해야 합니다.

앱이 프로비전되면 고유한 DNS 도메인 이름(예: 앱- 12345678ABCDEF.ContosoApps.com, 여기서 12345678ABCDEF 는 앱의 고유 식별자임)을 프로비전합니다. 이러한 고유한 이름을 지원하려면 DNS 도메인에 대한 와일드카드 CNAME(정식 이름) 항목이 필요합니다.

WINS 정방향 조회를 사용하는 등, 구성에 따라 새 정방향 조회 영역을 먼저 만들어야 하거나 SharePoint Server 사이트 도메인과 동일한 영역에서 와일드카드 CNAME 항목을 사용하여 작업을 시작할 수도 있습니다. 다음 절차에서는 정방향 조회 영역을 만든 다음, 개별 앱이 앱 도메인 내에서 고유한 도메인 이름을 만들 수 있도록 DNS 도메인 이름에 대한 와일드카드 별칭 레코드를 만듭니다. 이 절차에서는 Windows Server 2012 R2용 DNS 관리자를 사용합니다. 다른 유형의 DNS 서버가 있는 경우 서버 유형에 대한 설명서의 지침을 따르세요.

앱 도메인 이름에 대해 정방향 조회 영역을 만들려면

이 절차를 수행하는 사용자 계정이 도메인 컨트롤러의 도메인 관리자인지 확인합니다.
시작을 클릭하고 관리 도구를 가리킨 다음 DNS를 클릭합니다.
DNS 관리자에서 정방향 조회 영역을 마우스 오른쪽 단추로 클릭한 후에 새 영역...을 클릭합니다.
새 영역 마법사에서 다음을 클릭합니다.
영역 형식 페이지에서 기본값인 주 영역을 적용하고 다음을 클릭합니다.
Active Directory 영역 복제 범위 페이지에서 환경에 적합한 복제 방법을 선택하고(기본값은 이 도메인에 있는 모든 DNS 서버) 다음을 클릭합니다.
영역 이름 페이지의 영역 이름 상자에 새 앱 도메인 이름을 ContosoApps.com과 같이 입력하고 다음을 클릭합니다.
동적 업데이트 페이지에서 환경에 적합한 동적 업데이트 유형을 선택하고(기본값은 동적 업데이트 허용 안 함) 다음을 클릭합니다.
새 영역 마법사 완료 페이지에서 설정을 검토하고 마침을 클릭합니다.

이제 환경의 앱에 사용할 정방향 조회 영역 및 도메인 이름을 만들었습니다.

새 도메인 이름용 와일드카드 별칭(CNAME) 레코드를 만들려면

이 절차를 수행하는 사용자 계정이 도메인 컨트롤러의 도메인 관리자인지 확인합니다.
DNS 관리자에서 정방향 조회 영역 아래의 새 앱 도메인 이름을 마우스 오른쪽 단추로 클릭하고 새 별칭(CNAME)을 클릭합니다.
새 리소스 레코드 대화 상자의 별칭 이름(비어 있는 경우 부모 도메인 사용) 상자에 *를 입력합니다.

FQDN(정규화된 도메인 이름) 상자에 *가 표시됩니다. 다음에 앱용으로 만든 도메인 이름이 뒤따릅니다. 예를 들어 *.ContosoApps.com 또는 *.Contoso-Apps.com.
대상 호스트의 FQDN(정규화된 도메인 이름) 상자 옆에 SharePoint Server 사이트를 호스트하는 서버의 FQDN을 입력합니다.

예를 들어 SharePoint.Contoso.com과 같이 입력할 수 있습니다.

또는
대상 호스트의 FQDN(정규화된 도메인 이름) 상자에서 찾아보기를 클릭하고 SharePoint Server 사이트를 호스트하는 도메인의 정방향 조회 영역으로 이동합니다.

예를 들어 Contoso.com으로 이동합니다.
그런 다음 SharePoint Server 사이트를 호스트하는 서버를 가리키는 레코드로 이동합니다.

예를 들어 SharePoint로 이동할 수 있습니다.

새 리소스 레코드 대화 상자에는 앱 도메인에 대한 와일드카드 별칭과 SharePoint 사이트를 호스트하는 서버의 FQDN이 표시됩니다.
확인을 클릭합니다.

새 도메인 이름 및 별칭은 ping을 통해 확인할 수 있습니다.

새 도메인 이름을 확인하려면

이 절차를 수행하는 사용자 계정이 도메인 컨트롤러의 도메인 관리자인지 확인합니다.
시작을 클릭하고 명령 프롬프트를 클릭합니다.
명령 프롬프트에 ping 을 입력하고 앞서 만든 도메인의 하위 도메인을 입력한 다음 Enter 키를 누릅니다.

예: ping Apps-12345678ABCDEF.contosoapps.com

ping 명령에서 올바른 IP 주소가 반환되면 도메인 이름용 와일드카드가 정상적으로 구성된 것입니다.

새 와일드카드 SSL 인증서 만들기

사용자 환경에서 SharePoint Server 사이트에 대해 SSL(Secure Sockets Layer)을 사용하는 경우 또는 SharePoint Server 사이트에 대해 외부 데이터를 사용하는 앱을 사용 중인 경우 앱에 대해 SSL을 사용해야 합니다. SSL을 사용하려면 앱 도메인(예: ContosoApps.com)에 대해 SSL 인증서를 만듭니다.

도메인은 *.ContosoApps.com과 같은 와일드카드 형식으로 추가해야 합니다. 설치된 각 앱에는 자체 하위 도메인이 있으므로 개별 인증서 대신 와일드카드 인증서가 필요합니다.

SharePoint Server 앱 도메인을 사용한 SSL 오프로드 지원을 허용하려면 다음 Microsoft PowerShell 명령을 사용하여 여러 앱 도메인에 대한 지원을 사용하도록 설정합니다.

$contentService = [Microsoft.SharePoint.Administration.SPWebService]::ContentService
$contentService.SupportMultipleAppDomains = $true
$contentService.Update()
iisreset

가입 설정 및 앱 관리 서비스 응용 프로그램 구성

앱에는 App Management 및 Microsoft SharePoint Foundation Subscription Settings Service 응용 프로그램이 필요합니다. 다음 절차에 따라 구성합니다.

Microsoft SharePoint Foundation Subscription Settings Service를 켜려면

중앙 관리의 시스템 설정에서 이 팜의 서비스 관리를 클릭합니다.
Microsoft SharePoint Foundation Subscription Settings Service에 대해 자동 구축 사용을 클릭합니다.

다음으로 Microsoft PowerShell을 사용하여 구독 설정 서비스 애플리케이션 및 프록시를 만듭니다. New-SPSubscriptionSettingsServiceApplication에 제공된 예제 스크립트를 사용합니다.

App Management Service 응용 프로그램도 필요합니다. 다음 절차에 구성 단계가 나와 있습니다.

App Management Service 응용 프로그램을 만들려면

중앙 관리의 응용 프로그램 관리에서 서비스 응용 프로그램 관리를 클릭합니다.
새로 만들기를 클릭하고 App Management Service를 클릭합니다.
서비스 응용 프로그램 이름 상자에 서비스 응용 프로그램의 이름을 입력합니다.
응용 프로그램 풀의 기존 응용 프로그램 풀 목록 사용에서 SharePoint 웹 서비스 기본값을 선택합니다.
확인을 클릭합니다.

앱 도메인 및 앱 접두사 지정

이 섹션에서는 환경의 앱에 사용할 앱 도메인 및 앱 접두사를 지정합니다. 앱 URL은 각 앱 이름 지정 방법을 결정하는 접두사와 앱 도메인을 가리킵니다.

다음 절차에 따라 앱 URL을 구성합니다.

앱 URL을 구성하려면

중앙 관리에서 앱을 클릭합니다.
앱 페이지에서 앱 URL 구성을 클릭합니다.
앱 도메인 상자에 앱 호스팅용으로 만든 격리 도메인을 입력합니다(예: ContosoApps.com).
앱 접두사 상자에 앱의 URL 접두사로 사용할 이름을 입력합니다.

예를 들어 "apps"를 접두사로 사용하면 각 앱의 URL이 "apps- 12345678ABCDEF.ContosoApps.com"과 같이 표시됩니다.
확인을 클릭합니다.
앱을 설치하고 앱 접두사(사이트 구독 이름이라고도 함)를 변경한 경우 앱을 호스트하는 WWW 서비스(World Wide Web Publishing Service)를 다시 시작하는 것과 관련된 더 많은 단계를 수행해야 합니다.

중요

WWW 서비스를 다시 시작하면 IIS Admin 서비스와 Windows Process Activation Service도 다시 시작됩니다. 이러한 서비스를 사용하는 웹 사이트와 응용 프로그램도 모두 종료되며, 기존 상태가 손실될 수도 있고, 서비스가 성공적으로 다시 시작될 때까지 사용할 수 없습니다. > 앱 접두사 이름 바꾸기 작업을 완료하려면 다음과 같이 하세요. > 앱 접두사 이름 바꾸기 작업을 완료하려면 SharePoint 타이머 서비스 중지 단계를 > 수행합니다. > 앱을 호스트하는 World Wide Web Publishing Service를 다시 시작합니다. > SharePoint 타이머 서비스를 시작합니다.

다중 테넌트 설정(선택 사항)

환경에서 여러 테넌트를 호스트하는 경우에는 Microsoft PowerShell을 사용하여 각 테넌트에 대한 앱 URL을 구성해야 합니다. 다음 절차에 따라 구성합니다.

Windows PowerShell을 사용하여 앱 URL을 구성하려면

SharePoint 관리 셸을 엽니다.
Microsoft PowerShell 명령 프롬프트에 다음 명령을 입력하고 각 명령 끝에서 Enter 키를 누릅니다.
```
Set-SPAppDomain <appDomain>

Set-SPAppSiteSubscriptionName -Name "app" -Confirm:$false
```
여기서 각 부분이 나타내는 의미는 다음과 같습니다.
- <appDomain>은 작성한 도메인 이름입니다.
앱을 설치할 예정이며 앱 접두사(사이트 구독 이름이라고도 함)를 변경한 경우 앱을 호스트하는 WWW 서비스(World Wide Web Publishing 서비스) 다시 시작을 포함하는 추가 단계를 수행해야 합니다.

중요

WWW 서비스를 다시 시작하면 IIS Admin 서비스와 Windows Process Activation Service도 다시 시작됩니다. 이러한 서비스를 사용하는 웹 사이트와 응용 프로그램도 모두 종료되며, 기존 상태가 손실될 수도 있고, 서비스가 성공적으로 다시 시작될 때까지 사용할 수 없습니다. > 앱 접두사 이름 바꾸기 작업을 완료하려면 다음과 같이 하세요. > 앱 접두사 이름 바꾸기 작업을 완료하려면 SharePoint 타이머 서비스 중지 단계를 > 수행합니다. > 앱을 호스트하는 World Wide Web Publishing Service를 다시 시작합니다. > SharePoint 타이머 서비스를 시작합니다.

자세한 내용은 Set-SPAppSiteSubscriptionName 및 Set-SPAppDomain을 참조하세요.

인터넷 연결 끝점 기능 구성(선택 사항)

SharePoint 스토어에는 인터넷 연결 끝점이 필요한 사이트에 사용하기 위한 SharePoint용 앱이 포함됩니다. 기본적으로 이러한 앱은 대부분의 사이트와 호환되지 않기 때문에 사용할 수 없습니다(회색으로 표시되어 있고 구입할 수 없음). 하지만 인터넷 연결 끝점을 허용하도록 팜이 구성되어 있으면 인터넷 연결 끝점 기능을 켜서 이러한 앱을 SharePoint 스토어에 표시할 수 있습니다. 중앙 관리에서 이 기능을 켭니다.

앱에 대해 인터넷 연결 끝점을 구성하려면

중앙 관리에서 응용 프로그램 관리를 클릭합니다.
응용 프로그램 관리 페이지에서 웹 응용 프로그램 관리를 클릭합니다.
웹 응용 프로그램 관리 페이지에서 변경하려는 웹 응용 프로그램을 선택합니다.
리본 메뉴에서 기능 관리를 클릭합니다.
기능 목록의 액세스 가능한 인터넷 연결 끝점이 필요한 앱 옆에서 활성화를 클릭합니다.
확인을 클릭합니다.

경우에 따라 업데이트가 가끔만 설치되는 온-프레미스 SharePoint Server 팜이 있을 때 cmdlet을 실행하여 SharePoint 스토어를 가리키는 데 사용되는 URL을 업데이트해야 합니다.

Set-SPAppStoreConfiguration -Url http://office.microsoft.com -Enable $true

참고 항목

개념

SharePoint Server용 앱 계획

SharePoint Server용 앱 설치 및 관리