SharePoint Server용 앱의 환경 구성Configure an environment for apps for SharePoint Server

적용 대상: 예2013 예2016 yes2019 SharePointOnline 없음APPLIES TO: yes2013 yes2016 yes2019 noSharePoint Online

사용자가 사이트에서 SharePoint용 앱을 설치 및 사용할 수 있도록 하려면 앱을 지원하도록 환경을 구성해야 합니다. 이 문서에서는 앱을 지원하도록 환경을 구성하는 방법을 설명합니다. 이 문서의 구성 설정에 사용할 값을 확인하고 옵션을 검토하려면 SharePoint Server용 앱 계획 문서를 참조하세요.To enable users to install and use apps for SharePoint in their sites, you must configure your environment to support them. This article describes how to configure your environment to support apps. Use the Plan for apps for SharePoint Server article to review options and determine the values to use for configuration settings in this article.

시작하기 전에Before you begin

  • 앱에 대한 도메인 이름 공급자에서 도메인 이름을 구입해야 합니다(예: ContosoApps.com).You must purchase a domain name from a domain name provider for your apps, for example, ContosoApps.com.

  • 이 문서의 단계를 수행하려면 Farm Administrators 그룹의 구성원이어야 합니다. 일부 단계의 경우에는 도메인 관리자 권한도 필요합니다.You must be a member of the Farm Administrators group to perform the steps in this article. For some steps, you must also be a domain administrator.

  • 다중 테넌트 환경인 경우 Microsoft PowerShell을 사용하여 몇 가지 단계를 수행해야 합니다. Windows PowerShell을 사용하여 SharePoint Server 관리 권한이 있는지 확인합니다.If you have a multi-tenant environment, you need to do some steps by using Microsoft PowerShell. Make sure you have permissions to administer SharePoint Server using Windows PowerShell.

DNS의 도메인 이름 구성Configure the domain names in DNS

DNS(Domain Name Services)의 새 도메인이 앱을 호스트하도록 구성해야 합니다. 보안을 강화하려면 도메인 이름이 SharePoint Server 사이트를 호스트하는 도메인의 하위 도메인이 아니어야 합니다. 예를 들어 SharePoint Server 사이트가 Contoso.com에 있으면 도메인 이름으로 App.Contoso.com 대신 ContosoApps.com을 고려해야 합니다.You must configure a new domain in Domain Name Services (DNS) to host the apps. To help improve security, the domain name should not be a subdomain of the domain that hosts the SharePoint Server sites. For example, if the SharePoint Server sites are at Contoso.com, consider ContosoApps.com instead of App.Contoso.com as the domain name.

앱이 구축될 때 고유한 DNS 도메인 이름을 구축합니다(예를 들어 Apps- 12345678ABCDEF.ContosoApps.com. 여기서 _12345678ABCDEF_는 앱의 고유 식별자임). 이러한 고유한 이름을 지원하려면 DNS 도메인에 대해 와일드카드 정식 이름(CNAME) 항목이 필요합니다.When an app is provisioned, it provisions a unique DNS domain name (for example, Apps- 12345678ABCDEF.ContosoApps.com, where 12345678ABCDEF is a unique identifier for the app). You need a wildcard Canonical Name (CNAME) entry for your DNS domain to support these unique names.

WINS 정방향 조회를 사용하는 등, 구성에 따라 새 정방향 조회 영역을 먼저 만들어야 하거나 SharePoint Server 사이트 도메인과 동일한 영역에서 와일드카드 CNAME 항목을 사용하여 작업을 시작할 수도 있습니다. 다음 절차에서는 정방향 조회 영역을 만든 다음, 개별 앱이 앱 도메인 내에서 고유한 도메인 이름을 만들 수 있도록 DNS 도메인 이름에 대한 와일드카드 별칭 레코드를 만듭니다. 이 절차에서는 Windows Server 2012 R2용 DNS 관리자를 사용합니다. 다른 유형의 DNS 서버가 있는 경우 서버 유형에 대한 설명서의 지침을 따르세요.Depending on your configuration (for example, if you are using WINS forward lookup), you might have to create a new forward lookup zone first, or you can start with a wildcard CNAME entry in the same zone as the SharePoint Server site domain. In the following procedures, you create a forward lookup zone, and then create a wildcard alias record for the DNS domain name that allows for individual apps to create unique domain names within your app domain. In these procedures, we use DNS Manager for Windows Server 2012 R2. If you have a different type of DNS server, follow the procedures in the documentation for that server type.

앱 도메인 이름에 대해 정방향 조회 영역을 만들려면To create a forward lookup zone for the app domain name

  1. 이 절차를 수행하는 사용자 계정이 도메인 컨트롤러의 도메인 관리자인지 확인합니다.Verify that the user account that performs this procedure is a domain administrator on the domain controller.

  2. 시작을 클릭하고 관리 도구를 가리킨 다음 DNS를 클릭합니다.Click Start, point to Administrative Tools, and then click DNS.

  3. DNS 관리자에서 정방향 조회 영역을 마우스 오른쪽 단추로 클릭한 후에 새 영역... 을 클릭합니다.In DNS Manager, right-click Forward Lookup Zones, and then click New Zone….

  4. 새 영역 마법사에서 다음을 클릭합니다.In the New Zone Wizard, click Next.

  5. 영역 형식 페이지에서 기본값인 주 영역을 적용하고 다음을 클릭합니다.In the Zone Type page, accept the default of Primary zone, and then click Next.

  6. Active Directory 영역 복제 범위 페이지에서 환경에 적합한 복제 방법을 선택하고(기본값은 이 도메인에 있는 모든 DNS 서버) 다음을 클릭합니다.In the Active Directory Zone Replication Scope page, select the appropriate replication method for your environment (the default is To all DNS servers in this domain), and then click Next.

  7. 영역 이름 페이지의 영역 이름 상자에 새 앱 도메인 이름을 ContosoApps.com과 같이 입력하고 다음을 클릭합니다.In the Zone Name page, in the Zone name box type the name for your new app domain name (for example, ContosoApps.com), and then click Next.

  8. 동적 업데이트 페이지에서 환경에 적합한 동적 업데이트 유형을 선택하고(기본값은 동적 업데이트 허용 안 함) 다음을 클릭합니다.On the Dynamic Update page, select the appropriate type of dynamic updates for your environment (the default is Do not allow dynamic updates), and then click Next.

  9. 새 영역 마법사 완료 페이지에서 설정을 검토하고 마침을 클릭합니다.On the Completing the New Zone Wizard page, review the settings, and then click Finish.

이제 환경의 앱에 사용할 정방향 조회 영역 및 도메인 이름을 만들었습니다.You have now created a forward lookup zone (and a domain name) to use for apps in your environment.

새 도메인 이름용 와일드카드 별칭(CNAME) 레코드를 만들려면To create a wildcard Alias (CNAME) record for the new domain name

  1. 이 절차를 수행하는 사용자 계정이 도메인 컨트롤러의 도메인 관리자인지 확인합니다.Verify that the user account that performs this procedure is a domain administrator on the domain controller.

  2. DNS 관리자에서 정방향 조회 영역 아래의 새 앱 도메인 이름을 마우스 오른쪽 단추로 클릭하고 새 별칭(CNAME) 을 클릭합니다.In DNS Manager, under Forward Lookup Zones, right-click the new app domain name, and then click New Alias (CNAME).

  3. 새 리소스 레코드 대화 상자의 별칭 이름(입력하지 않으면 부모 도메인 사용) 상자에 *를 입력합니다.In the New Resource Record dialog box, in the Alias name (uses parent domain if left blank) box, type *.

    FQDN(정규화된 도메인 이름) 상자에는 *. 뒤에 앱용으로 만든 도메인 이름이 붙은 항목이 표시됩니다(예: *.ContosoApps.com 또는 *.Contoso-Apps.com).The Fully qualified domain name (FQDN) box displays *. followed by the domain name that you created for apps. For example, *.ContosoApps.com or *.Contoso-Apps.com.

  4. 대상 호스트의 FQDN(정규화된 도메인 이름) 상자 옆에 SharePoint Server 사이트를 호스트하는 서버의 FQDN을 입력합니다.Next to the Fully qualified domain name (FQDN) for target host box, type the FQDN of the server that hosts the SharePoint Server sites.

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

    또는Or:

  5. 대상 호스트의 FQDN(정규화된 도메인 이름) 상자에서 찾아보기를 클릭하고 SharePoint Server 사이트를 호스트하는 도메인의 정방향 조회 영역으로 이동합니다.Next to the Fully qualified domain name (FQDN) for target host box, click Browse and navigate to the Forward Lookup Zone for the domain that hosts the SharePoint Server sites.

    예를 들어 Contoso.com으로 이동합니다.For example, Contoso.com.

  6. 그런 다음 SharePoint Server 사이트를 호스트하는 서버를 가리키는 레코드로 이동합니다.And then navigate to the record that points to the server that hosts the SharePoint Server site.

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

    새 리소스 레코드 대화 상자에는 SharePoint 사이트를 호스트하는 서버의 앱 도메인 및 FQDN에 대한 와일드카드 별칭이 표시됩니다.New Resource Record dialog box shows the wildcard alias for the app domain and the FQDN of the server that hosts the SharePoint sites.

    앱 도메인에 대한 CNAME 별칭 만들기

  7. 확인을 클릭합니다.Click OK.

새 도메인 이름 및 별칭은 ping을 통해 확인할 수 있습니다.You can verify the new domain name and alias by pinging them.

새 도메인 이름을 확인하려면To verify the new domain name

  1. 이 절차를 수행하는 사용자 계정이 도메인 컨트롤러의 도메인 관리자인지 확인합니다.Verify that the user account that is performing this procedure is a domain administrator on the domain controller.

  2. 시작을 클릭하고 명령 프롬프트를 클릭합니다.Click Start, and then click Command Prompt.

  3. 명령 프롬프트에 ping 을 입력하고 앞서 만든 도메인의 하위 도메인을 입력한 다음 Enter 키를 누릅니다.At the command prompt, type ping followed by a subdomain of the domain that you created, and then press ENTER.

    예: ping Apps-12345678ABCDEF.contosoapps.comFor example, ping Apps-12345678ABCDEF.contosoapps.com

    ping 명령에서 올바른 IP 주소가 반환되면 도메인 이름용 와일드카드가 정상적으로 구성된 것입니다.If the ping command returns the correct IP address, then your wildcard for the domain name was configured successfully.

새 와일드카드 SSL 인증서 만들기Create a new wildcard SSL certificate

사용자 환경에서 SharePoint Server 사이트에 대해 SSL(Secure Sockets Layer)을 사용하는 경우 또는 SharePoint Server 사이트에 대해 외부 데이터를 사용하는 앱을 사용 중인 경우 앱에 대해 SSL을 사용해야 합니다. SSL을 사용하려면 앱 도메인(예: ContosoApps.com)에 대해 SSL 인증서를 만듭니다.If you are using Secure Sockets Layer (SSL) for the SharePoint Server sites in your environment, or if you use any apps that use data external to the SharePoint Server sites, you should use SSL for your apps. To use SSL, you create an SSL certificate for your app domain (for example, ContosoApps.com).

도메인은 *.ContosoApps.com과 같은 와일드카드 형식으로 추가해야 합니다. 설치된 각 앱에는 자체 하위 도메인이 있으므로 개별 인증서 대신 와일드카드 인증서가 필요합니다.The domain should be added in the form of a wildcard (for example, *.ContosoApps.com). You need a wildcard certificate instead of individual certificates because each installed app has its own subdomain.

SharePoint Server 앱 도메인을 사용한 SSL 오프로드를 지원하려면 다음 Microsoft PowerShell 명령을 사용하여 여러 앱 도메인에 대한 지원을 사용하도록 설정해야 합니다.Note that in order to allow support for SSL offloading with SharePoint Server App Domains you must enable support for multiple app domains by using the following Microsoft PowerShell commands:

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

가입 설정 및 앱 관리 서비스 응용 프로그램 구성Configure the Subscription Settings and App Management service applications

앱에는 App Management 및 Microsoft SharePoint Foundation Subscription Settings Service 응용 프로그램이 필요합니다. 다음 절차에 따라 구성합니다.Apps rely on the App Management and Microsoft SharePoint Foundation Subscription Settings service applications. Use the following procedures to configure them.

Microsoft SharePoint Foundation Subscription Settings Service를 켜려면To turn on the Microsoft SharePoint Foundation Subscription Settings Service

  1. 중앙 관리의 시스템 설정에서 이 팜의 서비스 관리를 클릭합니다.In Central Administration, under System Settings, click Manage services in this farm.

  2. Microsoft SharePoint Foundation Subscription Settings Service에 대해 자동 구축 사용을 클릭합니다.For the Microsoft SharePoint Foundation Subscription Settings Service, click Enable Auto Provision

다음으로 Subscription Settings Service 응용 프로그램 및 프록시를 만듭니다. 이러한 항목은 Microsoft PowerShell을 사용하여 만들어야 합니다. New-SPSubscriptionSettingsServiceApplication에 제공된 예제 스크립트를 사용합니다.Next, create a Subscription Settings service application and proxy. These must be created by using Microsoft PowerShell. Use the example script provided at New-SPSubscriptionSettingsServiceApplication.

App Management Service 응용 프로그램도 필요합니다. 다음 절차에 구성 단계가 나와 있습니다.You also need an App Management service application. The following procedures provide the steps to configure it.

App Management Service 응용 프로그램을 만들려면To create a App Management service application

  1. 중앙 관리의 응용 프로그램 관리에서 서비스 응용 프로그램 관리를 클릭합니다.In Central Administration, under Application Management, click Manage service applications.

  2. 새로 만들기를 클릭하고 App Management Service를 클릭합니다.Click New, and then click App Management Service.

  3. 서비스 응용 프로그램 이름 상자에 서비스 응용 프로그램의 이름을 입력합니다.Type a name for the service application in the Service Application Name box.

  4. 응용 프로그램 풀기존 응용 프로그램 풀 목록 사용에서 SharePoint 웹 서비스 기본값을 선택합니다.Under Application Pool, choose SharePoint Web Services Default from the Use existing application pool list.

  5. 확인을 클릭합니다.Click OK.

앱 도메인 및 앱 접두사 지정Specify the app domain and app prefix

이 섹션에서는 환경의 앱에 사용할 앱 도메인 및 앱 접두사를 지정합니다. 앱 URL은 각 앱 이름 지정 방법을 결정하는 접두사와 앱 도메인을 가리킵니다.In this section, you specify the app domain and app prefix to use for apps in your environment. The app URL points to your app domain and a prefix that determines how each app is named.

다음 절차에 따라 앱 URL을 구성합니다.Use the following procedure to configure app URLs.

앱 URL을 구성하려면To configure app URLs

  1. 중앙 관리에서 을 클릭합니다.In Central Administration, click Apps.

  2. 페이지에서 앱 URL 구성을 클릭합니다.On the Apps page, click Configure App URLs.

  3. 앱 도메인 상자에 앱 호스팅용으로 만든 격리 도메인을 입력합니다(예: ContosoApps.com).In the App domain box, type the isolated domain that you created for hosting apps (for example, ContosoApps.com).

  4. 앱 접두사 상자에 앱의 URL 접두사로 사용할 이름을 입력합니다.In the App prefix box, type a name to use for the URL prefix for apps.

    예를 들어 "apps"를 접두사로 사용하면 각 앱의 URL이 "apps- 12345678ABCDEF.ContosoApps.com"과 같이 표시됩니다.(For example, you could use "apps" as the prefix, and you would see a URL for each app such as "apps- 12345678ABCDEF.ContosoApps.com".)

  5. 확인을 클릭합니다.Click OK.

  6. 앱을 설치할 예정이며 앱 접두사(사이트 구독 이름이라고도 함)를 변경한 경우 앱을 호스트하는 WWW 서비스(World Wide Web Publishing 서비스) 다시 시작을 포함하는 추가 단계를 수행해야 합니다.If you will install apps and you have changed the App prefix (also known as the site subscription name), you must perform additional steps that involve restarting the World Wide Web Publishing Service (WWW Service) that hosts the apps.

    중요

    WWW 서비스를 다시 시작하면 IIS Admin 서비스와 Windows Process Activation Service도 다시 시작됩니다. 이러한 서비스를 사용하는 웹 사이트와 응용 프로그램도 모두 종료되며, 기존 상태가 손실될 수도 있고, 서비스가 성공적으로 다시 시작될 때까지 사용할 수 없습니다. > 앱 접두사 이름 바꾸기 작업을 완료하려면 다음과 같이 하세요. > SharePoint Timer Service를 중지합니다. > 앱을 호스트하는 World Wide Web Publishing 서비스를 다시 시작합니다. > SharePoint Timer Service를 시작합니다.Restarting the WWW Service will also restart the IIS Admin Service and the Windows Process Activation Service. This will also shut down all Web sites and applications that depend on these services and they may lose existing state and will be unavailable until the services successfully restart. You should plan to perform these steps during a planned maintenance time. > To complete the App prefix rename tasks, perform these steps: > Stop the SharePoint Timer service. > Restart the World Wide Web Publishing Service that hosts the apps. > Start the SharePoint Timer service.

다중 테넌트 설정(선택 사항)Multi-tenant settings (Optional)

환경에서 여러 테넌트를 호스트하는 경우에는 Microsoft PowerShell을 사용하여 각 테넌트에 대한 앱 URL을 구성해야 합니다. 다음 절차에 따라 구성합니다.If you host multiple tenants in your environment, you must use Microsoft PowerShell to configure app URLs for each tenant. Use the following procedure to configure them.

Windows PowerShell을 사용하여 앱 URL을 구성하려면To configure app URLs by using Windows PowerShell

  1. SharePoint 관리 셸을 엽니다.Open the SharePoint Management Shell.

  2. Microsoft PowerShell 명령 프롬프트에 다음 명령을 입력하고 각 명령 끝에서 Enter 키를 누릅니다.At the Microsoft PowerShell command prompt, type the following commands and press ENTER after each one:

    Set-SPAppDomain <appDomain>
    
    Set-SPAppSiteSubscriptionName -Name "app" -Confirm:$false
    

    여기서 각 부분이 나타내는 의미는 다음과 같습니다.Where:

    • <appDomain> 은 작성한 도메인 이름입니다.<appDomain> is the domain name that you created.
  3. 앱을 설치할 예정이며 앱 접두사(사이트 구독 이름이라고도 함)를 변경한 경우 앱을 호스트하는 WWW 서비스(World Wide Web Publishing 서비스) 다시 시작을 포함하는 추가 단계를 수행해야 합니다.If you will install apps and you have changed the App prefix (also known as the site subscription name), you must perform additional steps that involve restarting the World Wide Web Publishing Service (WWW Service) that hosts the apps.

    중요

    WWW 서비스를 다시 시작하면 IIS Admin 서비스와 Windows Process Activation Service도 다시 시작됩니다. 이러한 서비스를 사용하는 웹 사이트와 응용 프로그램도 모두 종료되며, 기존 상태가 손실될 수도 있고, 서비스가 성공적으로 다시 시작될 때까지 사용할 수 없습니다. > 앱 접두사 이름 바꾸기 작업을 완료하려면 다음과 같이 하세요. > SharePoint Timer Service를 중지합니다. > 앱을 호스트하는 World Wide Web Publishing 서비스를 다시 시작합니다. > SharePoint Timer Service를 시작합니다.Restarting the WWW Service will also restart the IIS Admin Service and the Windows Process Activation Service. This will also shut down all Web sites and applications that depend on these services and they may lose existing state and will be unavailable until the services successfully restart. You should plan to perform these steps during a planned maintenance time. > To complete the App prefix rename tasks, perform these steps: > Stop the SharePoint Timer service. > Restart the World Wide Web Publishing Service that hosts the apps. > Start the SharePoint Timer service.

자세한 내용은 Set-SPAppSiteSubscriptionName 및 Set-SPAppDomain을 참조하세요.For more information, see Set-SPAppSiteSubscriptionName and Set-SPAppDomain.

인터넷 연결 끝점 기능 구성(선택 사항)Configure the Internet-facing endpoints feature (Optional)

SharePoint 스토어에는 인터넷 연결 끝점이 필요한 사이트에 사용하기 위한 SharePoint용 앱이 포함됩니다. 기본적으로 이러한 앱은 대부분의 사이트와 호환되지 않기 때문에 사용할 수 없습니다(회색으로 표시되어 있고 구입할 수 없음). 하지만 인터넷 연결 끝점을 허용하도록 팜이 구성되어 있으면 인터넷 연결 끝점 기능을 켜서 이러한 앱을 SharePoint 스토어에 표시할 수 있습니다. 이 기능은 중앙 관리에서 켭니다.The SharePoint Store contains apps for SharePoint intended for use with sites that require Internet-facing endpoints. By default, these apps are not available (greyed out and cannot be purchased) because they are incompatible with most sites. However, if your farm is configured to allow internet-facing end points, you can turn on the Internet-facing endpoints feature to show these apps in the SharePoint Store. You turn this feature on in Central Administration.

앱에 대해 인터넷 연결 끝점을 구성하려면To configure Internet-facing endpoints for apps

  1. 중앙 관리에서 응용 프로그램 관리를 클릭합니다.In Central Administration, click Application Management.

  2. 응용 프로그램 관리 페이지에서 웹 응용 프로그램 관리를 클릭합니다.On the Application Management page, click Manage Web applications.

  3. 웹 응용 프로그램 관리 페이지에서 변경하려는 웹 응용 프로그램을 선택합니다.On the Manage Web Applications page, select the web application that you want to change.

  4. 리본 메뉴에서 기능 관리를 클릭합니다.On the ribbon, click Manage Features.

  5. 기능 목록의 액세스 가능한 인터넷 연결 끝점이 필요한 앱 옆에서 활성화를 클릭합니다.In the feature list, next to Apps that require accessible internet facing endpoints, click Activate.

  6. 확인을 클릭합니다.Click OK.

경우에 따라 업데이트가 가끔만 설치되는 온-프레미스 SharePoint Server 팜이 있을 때 cmdlet을 실행하여 SharePoint 스토어를 가리키는 데 사용되는 URL을 업데이트해야 합니다.In some cases, for example, when you have an on-premises SharePoint Server farm where updates are installed infrequently, you will need to run a cmdlet to update the URL used to point to the SharePoint Store:

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

참고 항목See also

개념Concepts

SharePoint Server용 앱 계획Plan for apps for SharePoint Server

SharePoint Server용 앱 설치 및 관리Install and manage apps for SharePoint Server