設定 SharePoint 應用程式的環境 (SharePoint 2013)

 

適用版本:SharePoint Foundation 2013, SharePoint Server 2013 Enterprise, SharePoint Server 2013 Standard

上次修改主題的時間:2016-12-16

摘要:設定 SharePoint 2013 應用程式的網域名稱、服務應用程式與 URL。

若要讓使用者在網站中安裝並使用 SharePoint 應用程式,您必須設定環境予以支援。本文說明如何設定環境以支援應用程式。可利用<規劃 SharePoint 2013 的應用程式>文章檢閱選項,然後決定本文中組態設定要採用的值。

重要事項重要事項:
本文中的步驟適用於 SharePoint Foundation 2013 與 SharePoint Server 2013。
SharePoint 2013 的 2013 年 3 月公用更新 其中一個功能更新是讓您可以在 SharePoint 2013 環境中,透過備用存取對應或主機標頭網頁應用程式設定,使用多個應用程式網域。如需詳細資訊,請參閱<針對 SharePoint 2013 在 AAM 中啟用應用程式或主機標頭環境>。

下圖摘要說明設定 SharePoint 應用程式 的環境所需的步驟。

如何設定 SharePoint 應用程式環境的概觀

設定應用程式環境的程序

這些設定步驟會產生以下的應用程式 URL 範例:

  • http://Apps-12345678ABCDEF.ContosoApps.com/sites/SiteName/App1Name/Pages/Home.aspx

  • https://Apps-3456789BCDEFG.ContosoApps.com/sites/SiteName/WebName/App2Name/Default.aspx

本文包含完成這些步驟的指示。

  • 您必須向網域名稱提供者購買網域名稱以用於應用程式,例如 ContosoApps.com。

    注意事項附註:
    基於安全考量,您的 SharePoint 伺服程式會在您裝載應用程式的不同網域中執行。影響是網際網路資訊服務 (IIS) 無法連接兩個網域,因此當您存取您的應用程式時可能會遇到錯誤。若要修正這個錯誤,您需要 Web 應用程式在連接埠 80 上,沒有主機標題。如需有關如何設定此作業的詳細資訊,請參閱<為 SharePoint 2013 設定應用程式的環境的疑難排解>中的<"Error 2">。
  • 您必須是伺服器陣列管理員群組的成員,才可執行本文中的步驟。有些步驟必須以網域控制站的網域系統管理員身份才能執行。

  • 確認 SharePoint 管理 (spadmin) 與 SharePoint 計時器 (sptimer) 服務正在運作。

    若要進行確認,請按一下 [開始],然後指向 [系統管理工具],再按一下 [服務]。在 [服務] 清單中,確認 [SharePoint 管理] 與 [SharePoint 計時器] 服務正在運作。

注意事項附註:
因為 SharePoint 2013 在網際網路資訊服務 (IIS) 中以網站形式運作,所以管理員與使用者均依賴瀏覽器提供的協助工具功能。SharePoint 2013 支援所支援瀏覽器的協助工具功能。如需詳細資訊,請參閱下列資源:

您必須在「網域名稱服務」(DNS) 中設定新的名稱,才能裝載應用程式。若要提高安全性,新的網域名稱不得為主控 SharePoint 網站之網域的子網域。例如 SharePoint 網站是在 Contoso.com,網域名稱請考慮使用 ContosoApps.com,而不要用 App.Contoso.com。如需詳細資訊,請參閱<規劃 SharePoint 2013 的應用程式>。佈建應用程式時,會佈建唯一的 DNS 網域名稱 (例如 Apps-12345678ABCDEF.ContosoApps.com,其中 12345678ABCDEF 即為該應用程式的唯一識別碼)。DNS 網域必須要有萬用字元「正式名稱」 (CNAME) 輸入項目,才能支援這些唯一名稱。

視您的設定而定 (例如,若使用 WINS 正向對應),可能需要先建立新的正向對應區域,或者可以在與 SharePoint 網站網域相同的區域中先建立萬用字元 CNAME 項目。在下列程序中,您將建立正向對應區域,然後建立 DNS 網域名稱的萬用字元別名記錄,這可讓個別應用程式在應用程式網域內建立唯一的網域名稱。在這些程序中,我們使用 Windows Server 2008 R2 的 DNS 管理員。如需 Windows Server 2008 R2 中 DNS 伺服器的詳細資訊,請參閱 DNS 伺服器。若您有其他類型的 DNS 伺服器,請遵循文件中針對該伺服器類型的程序。

建立應用程式網域名稱的正向對應區域
  1. 確認執行此程序的使用者帳戶為網域控制站的網域系統管理員。

  2. 按一下 [開始] ,然後指向 [系統管理工具],再按一下 [DNS]。

  3. 在「DNS 管理員」的 [正向對應區域] 上按一下滑鼠右鍵,然後按一下 [新區域...]。

  4. 在 [新區域精靈] 中,按 [下一步] 。

  5. 在「區域類型」頁面中,接受 [主要區域] 的預設值,然後按 [下一步]。

  6. 在「Active Directory 區域複寫領域」頁面中,為您的環境選擇合適的複寫方法 (預設為 [複寫至此網域中的所有 DNS 伺服器] ),然後按 [下一步]。

  7. 在「區域名稱」頁面的 [區域名稱] 方塊中,輸入新的應用程式網域名稱 (例如 ContosoApps.com),然後按 [下一步]。

    [新增區域精靈] 將顯示用於應用程式的新網域名稱。

    針對 SharePoint 的應用程式建立網域名稱
  8. 在「動態更新」頁面中,為您的環境選擇合適的動態更新類型 (預設為 [不允許動態更新] ),然後按 [下一步]。

  9. 在「完成新區域精靈」頁面上,檢視設定,然後按一下 [完成]。

如需如何建立正向對應區域的詳細資訊,請參閱<新增正向對應區域>。

您已在環境中建立正向對應區域 (與網域名稱),現在即可用於應用程式 。

為新網域名稱建立萬用字元別名 (CNAME) 記錄
  1. 確認執行此程序的使用者帳戶為網域控制站的網域系統管理員。

  2. 在「DNS 管理員」的「正向對應區域」下,於新應用程式的網域名稱上按滑鼠右鍵,然後按一下 [新別名 (CNAME)] 。

  3. 在 [新增資源記錄] 對話方塊的 [別名名稱] (若留白,系統將使用父系網域) 方塊中,輸入 *

    完整網域名稱 (FQDN) 方塊顯示 *.,後面加上您為應用程式建立的網域名稱,例如:*.ContosoApps.com 或 *.Contoso-Apps.com。

  4. 在 [目標主機完整網域名稱 (FQDN)] 方塊旁,輸入主控 SharePoint 網站之伺服器的 FQDN。

    例如 SharePoint.Contoso.com。

    或者:

    1. 在 [目標主機的完整網域名稱 (FQDN)] 方塊旁邊按一下 [瀏覽],然後瀏覽至主控 SharePoint 網站網域的「正向對應區域」。

      例如,contoso.com。

    2. 然後瀏覽到指向主控 SharePoint 網站伺服器的記錄。

      例如 SharePoint。

    [新增資源記錄] 對話方塊將顯示應用程式網域的萬用字元別名,以及主控 SharePoint 網站之伺服器的 FQDN。

    建立適用於應用程式網域的 CNAME 別名
  5. 按一下 [確定]。

如需如何在「DNS 管理員」中建立萬用字元別名記錄的詳細資訊,請參閱<將別名 (CNAME) 資源記錄加入區域>。

您可 Ping 新網域名稱與別名來驗證。

驗證新網域名稱
  1. 確認正在執行此程序的使用者帳戶為網域控制站的網域系統管理員。

  2. 按一下 [開始],然後按一下 [命令提示字元]。

  3. 在命令提示字元處輸入 ping,接著輸入您建立的網域子網域,然後按下 ENTER

    例如 ping Apps-12345678ABCDEF.contosoapps.com

    若 Ping 命令傳回正確的 IP 位址,代表您的網域名稱萬用字元已設定成功。

若在環境中的 SharePoint 網站上使用安全通訊端層 (SSL),或使用任何會使用 SharePoint 網站外部資料的應用程式,就應該對應用程式使用 SSL。若要使用 SSL,您需要針對應用程式網域建立 SSL 憑證 (例如 ContosoApps.com)。

必須以萬用字元的格式新增網域 (例如 *.ContosoApps.com)。您需要萬用字元憑證,而不是個別的憑證,因為各個安裝的應用程式都有專屬的子網域。

請注意,為了要允許支援使用 SharePoint 應用程式網域來進行 SSL 卸載,您必須使用下列 Windows PowerShell 命令,啟用對多個應用程式網域的支援︰

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

注意事項附註:
您可以從 SharePoint 伺服器透過 Internet Information Services (IIS) 提出憑證要求。關於產生要求的步驟,請參閱<要求網際網路伺服器憑證 (IIS 7)>。關於安裝網際網路伺服器憑證,請參閱<安裝網際網路伺服器憑證 (IIS 7)>。請參閱憑證授權單位的文件來取得和下載憑證。

應用程式依賴「應用程式管理」與「Microsoft SharePoint Foundation 訂閱設定」服務應用程式。這些服務應用程式使用多組織用戶管理功能,來提供應用程式權限以及建立應用程式的子網域。因此,即使沒有主控多重承租人,仍必須為環境的預設承租人建立名稱 (任何與承租人沒有關聯的 SharePoint 網站都將會包含在預設承租人中)。

注意事項附註:
您可在非主控環境中使用 SharePoint 管理中心網站來設定預設的承租人名稱 (也稱為應用程式前置詞)。您必須使用 Windows PowerShell 來設定主控環境的承租人名稱。執行步驟,設定下一節<設定要使用的應用程式 URL>的應用程式前置詞。

若要設定這些服務,請先在管理中心中啟動這些服務。服務啟動後,使用 Windows PowerShell 建立「訂閱設定」服務應用程式,然後使用 Windows PowerShell 或管理中心建立 App Management Service 應用程式。

在管理中心中啟動訂閱設定服務和 App Management Service
  1. 在管理中心中確認您是否為伺服器陣列管理員群組的成員。

  2. 在 SharePoint 2013 管理中心中,按一下 [系統設定]。

  3. 在「系統設定」頁面的 [伺服器] 之下,按一下 [管理伺服器上的服務]。

  4. 在「伺服器上的服務」頁面上,按一下 App Management Service 旁的 [啟動]。

  5. 在「伺服器上的服務」頁面上,按一下 Microsoft SharePoint Foundation 訂閱設定服務旁的 [啟動]。

  6. 確認 App Management Service 和 Microsoft SharePoint Foundation 訂閱設定服務是否執行。下圖顯示「伺服器上的服務」頁面,可在此確認 App Management Service 和訂閱設定服務是否執行。

    [伺服器上的服務] 顯示 App Management Service 和訂閱設定服務都在執行。

    確認服務正在執行中
使用 Windows PowerShell 設定訂閱設定服務應用程式
  1. 確認您具備下列成員身分:

    • SQL Server 執行個體上的 securityadmin 固定伺服器角色。

    • 所有要更新之資料庫上的 db_owner 固定資料庫角色。

    • 正在執行 Windows PowerShell Cmdlet 之所在伺服器上的管理員群組。

    系統管理員可使用 Add-SPShellAdmin Cmdlet 以授權使用 SharePoint 15 產品 Cmdlet。

    注意事項附註:
    如果您不具備上述權限,請連絡安裝程式系統管理員或 SQL Server 系統管理員要求權限。如需 Windows PowerShell 權限的其他資訊,請參閱<Add-SPShellAdmin>。
  2. 在 [開始] 功能表上,按一下 [所有程式]。

  3. 按一下 [Microsoft SharePoint 2013 產品]。

  4. 按一下 [SharePoint 2013 管理命令介面]。

  5. 首先,您必須建立服務的應用程式集區 (以帳戶形式運作) 及資料庫設定。以受管理帳戶用於 SPManagedAccount (這將作為應用程式集區的執行身分帳戶)。

    在 Windows PowerShell 命令提示字元處輸入以下命令,並在每個命令結尾按下 ENTER,以建立應用程式集區:

    $account = Get-SPManagedAccount "<AccountName>" 
    # Gets the name of the managed account and sets it to the variable $account for later use.
    

    其中:

    • <帳戶名稱> 是 SharePoint 伺服器陣列中受管理帳戶的名稱。

    $appPoolSubSvc = New-SPServiceApplicationPool -Name SettingsServiceAppPool -Account $account
    # Creates an application pool for the Subscription Settings service application. 
    # Uses a managed account as the security account for the application pool.
    # Stores the application pool as a variable for later use.
    

  6. 在 Windows PowerShell 命令提示字元處,輸入以下命令,並在每個命令結尾按下 ENTER,以建立新的服務應用程式和 Proxy:

    $appSubSvc = New-SPSubscriptionSettingsServiceApplication -ApplicationPool $appPoolSubSvc -Name SettingsServiceApp -DatabaseName <SettingsServiceDB>
    # Creates the Subscription Settings service application, using the variable to associate it with the application pool that was created earlier.
    # Stores the new service application as a variable for later use.
    

    其中:

    • <設定服務資料庫> 是「訂閱設定」服務資料庫的名稱。

    $proxySubSvc = New-SPSubscriptionSettingsServiceApplicationProxy -ServiceApplication $appSubSvc
    # Creates a proxy for the Subscription Settings service application.
    

如需詳細資訊,請參閱<Get-SPManagedAccount>、<New-SPServiceApplicationPool>、<New-SPSubscriptionSettingsServiceApplication>、<New-SPSubscriptionSettingsServiceApplicationProxy>。

您可使用 Windows PowerShell 或管理中心來建立及設定 App Management Service 應用程式。下列程序提供每個方法所需的步驟。

使用 Windows PowerShell 設定 App Management Service 應用程式
  1. 確認您具備下列成員身分:

    • SQL Server 執行個體上的 securityadmin 固定伺服器角色。

    • 所有要更新之資料庫上的 db_owner 固定資料庫角色。

    • 正在執行 Windows PowerShell Cmdlet 之所在伺服器上的管理員群組。

    系統管理員可使用 Add-SPShellAdmin Cmdlet 以授權使用 SharePoint 15 產品 Cmdlet。

    注意事項附註:
    如果您不具備上述權限,請連絡安裝程式系統管理員或 SQL Server 系統管理員要求權限。如需 Windows PowerShell 權限的其他資訊,請參閱<Add-SPShellAdmin>。
  2. 在 [開始] 功能表上,按一下 [所有程式]。

  3. 按一下 [Microsoft SharePoint 2013 產品]。

  4. 按一下 [SharePoint 2013 管理命令介面]。

  5. 首先,您必須建立服務的應用程式集區 (以帳戶形式運作) 及資料庫設定。以受管理帳戶用於 SPManagedAccount (這將作為應用程式集區的執行身分帳戶)。

    在 Windows PowerShell 命令提示字元處輸入以下命令,並在每個命令結尾按下 ENTER,以建立應用程式集區:

    $account = Get-SPManagedAccount "<AccountName>" 
    # Gets the name of the managed account and sets it to the variable $account for later use.
    

    其中:

    • <帳戶名稱> 是 SharePoint 伺服器陣列中受管理帳戶的名稱。

    $appPoolAppSvc = New-SPServiceApplicationPool -Name AppServiceAppPool -Account $account
    # Creates an application pool for the Application Management service application. 
    # Uses a managed account as the security account for the application pool.
    # Stores the application pool as a variable for later use.
    

  6. 在 Windows PowerShell 命令提示字元處,輸入以下命令,並在每個命令結尾按下 ENTER,以建立新的服務應用程式和 Proxy:

    $appAppSvc = New-SPAppManagementServiceApplication -ApplicationPool $appPoolAppSvc -Name AppServiceApp -DatabaseName <AppServiceDB>
    # Creates the Application Management service application, using the variable to associate it with the application pool that was created earlier.
    # Stores the new service application as a variable for later use.
    

    其中:

    • <應用程式服務資料庫> 是 App Management 服務資料庫的名稱。

    $proxyAppSvc = New-SPAppManagementServiceApplicationProxy -ServiceApplication $appAppSvc
    # Creates a proxy for the Application Management service application.
    

如需詳細資訊,請參閱<Get-SPManagedAccount>、<New-SPServiceApplicationPool>、<New-SPAppManagementServiceApplication>及<New-SPAppManagementServiceApplicationProxy>。

在管理中心建立 App Management Service 應用程式
  1. 在 SharePoint 2013 管理中心的「應用程式管理」頁面上,按一下 [管理服務應用程式]。

  2. 在功能區上按一下 [新增],然後按一下 [App Management Service]。

  3. 在「新增 App Management Service 應用程式」頁面的 [服務應用程式名稱] 方塊中,輸入服務應用程式的名稱。

  4. 在 [資料庫] 區段的 [資料庫伺服器] 方塊中,輸入要儲存資料庫的 SQL Server 執行個體,或使用預設伺服器。

  5. 在 [資料庫名稱] 方塊中,輸入資料庫名稱或使用預設名稱。

    資料庫名稱必須是唯一名稱。

  6. 在 [資料庫驗證] 下,執行下列其中一項操作以選取要使用的驗證:

    • 若要使用 Windows 驗證,請維持選取此選項。因為 Windows 驗證會在連線至 SQL Server 時對密碼自動加密,所以建議選取此選項。

    • 若要使用 SQL 驗證,請按一下 [SQL 驗證]。在 [帳戶] 方塊中,輸入服務應用程式向 SQL Server 資料庫進行驗證時所要使用的帳戶名稱,然後在 [密碼] 方塊中輸入密碼。

      注意事項附註:
      在 SQL 驗證中,密碼在傳送給 SQL Server 時不會加密。若要使用 SQL 驗證,建議您務必執行 SQL Server 的強制通訊協定加密,或使用 IPsec 加密網路流量。
  7. 若要使用容錯移轉資料庫伺服器,請在 [容錯移轉資料庫伺服器] 區段中指定伺服器名稱。

  8. 在 [應用程式集區] 區段中,執行下列其中一項操作:

    • 按一下 [使用現有的應用程式集區],然後從下拉式清單中選取您要使用的應用程式集區。

    • 按一下 [建立新的應用程式集區] 並輸入新應用程式集區的名稱,然後在 [選取應用程式集區的安全性帳戶] 下執行下列其中一項操作:

      • 按一下 [預先定義],以使用預先定義的安全性帳戶,然後從下拉式清單中選取安全性帳戶。

      • 按一下 [可設定],以指定現有應用程式集區所要使用的新安全性帳戶。您可以按一下 [註冊新的受管理帳戶] 連結建立新帳戶。

  9. 在 [建立 App Management Service 應用程式 Proxy] 區段中,保留 [建立 App Management Service 應用程式 Proxy 並將其新增至預設的 Proxy 群組] 核取方塊為選取的狀態。

  10. 按一下 [確定]。

    下圖顯示所建立的 App Management Service 應用程式和 Proxy。

    「管理服務應用程式」頁面顯示 App Management Service 應用程式和 Proxy。

    App Management Service 應用程式與 Proxy

    現在,必須在伺服器上啟動該服務。

  11. 在 SharePoint 2013 管理中心中,按一下 [系統設定]。

  12. 在「系統設定」頁面的 [伺服器] 之下,按一下 [管理伺服器上的服務]。

  13. 在「伺服器上的服務」頁面上,按一下 [App Management Service] 旁的 [啟動]。

在本節中,您會在環境中建立應用程式的網域前置詞與承租人名稱。應用程式 URL 指向應用程式網域及決定各應用程式命名的方式。若您在環境中主控多個承租人,則必須使用 Windows PowerShell 來設定應用程式 URL。

依照以下程序,使用管理中心來設定非主控 (單一承租人) 環境的應用程式 URL。

設定應用程式 URL
  1. 在管理中心中,按一下 [應用程式]。

  2. 在「應用程式」頁面按一下 [設定應用程式 URL]。

  3. 在 [應用程式網域] 方塊中,輸入您為主控應用程式建立的隔離網域。

    例如:ContosoApps.com 或 Contoso-Apps.com。

  4. 在 [應用程式前置詞] 方塊中,輸入要作為應用程式 URL 前置詞的名稱。

    例如,可將 "apps" 當作前置詞,這樣就會看見各個應用程式的 URL 如 "apps-12345678ABCDEF.ContosoApps.com"。下圖顯示已填入應用程式網域和前置詞的「設定應用程式 URL」頁面。

    管理中心中的「設定應用程式 URL」頁面顯示應用程式網域和應用程式前置詞。

    設定應用程式網域與前置詞
  5. 按一下 [確定]。

  6. 如果您要安裝應用程式而且您已經變更應用程式前置詞 (又稱為網站訂閱名稱),您必須執行與重新啟動主控應用程式之 World Wide Web Publishing 服務 (WWW 服務) 關聯的額外步驟。

    重要事項重要事項:
    重新啟動 WWW 服務也會重新啟動 IIS 系統管理服務與 Windows 處理序啟用服務,並且會關閉所有依賴這些服務的網站和應用程式。這可能會使它們遺失現有的狀態,要等成功重新啟動服務後才能再次使用。您應該規劃在計劃的維修時間執行這些步驟。
    若要完成應用程式前置詞重新命名工作,請執行這些步驟:
    1. 停止 SharePoint Timer Service。

    2. 重新啟動主控應用程式的 World Wide Web Publishing 服務。

    3. 啟動 SharePoint Timer Service。

依照以下步驟設定多重租賃主控環境的應用程式 URL。

使用 Windows PowerShell 設定應用程式 URL
  1. 確認您具備下列成員身分:

    • SQL Server 執行個體上的 securityadmin 固定伺服器角色。

    • 所有要更新之資料庫上的 db_owner 固定資料庫角色。

    • 正在執行 Windows PowerShell Cmdlet 之所在伺服器上的管理員群組。

    系統管理員可使用 Add-SPShellAdmin Cmdlet 以授權使用 SharePoint 15 產品 Cmdlet。

    注意事項附註:
    如果您不具備上述權限,請連絡安裝程式系統管理員或 SQL Server 系統管理員要求權限。如需 Windows PowerShell 權限的其他資訊,請參閱<Add-SPShellAdmin>。
  2. 在 [開始] 功能表上,按一下 [所有程式]。

  3. 按一下 [Microsoft SharePoint 2013 產品]。

  4. 按一下 [SharePoint 2013 管理命令介面]。

  5. 在 Windows PowerShell 命令提示字元處輸入以下命令,並在每個命令結尾按下 ENTER

    Set-SPAppDomain <appDomain>
    

    Set-SPAppSiteSubscriptionName -Name "app" -Confirm:$false
    

    其中:

    • <應用程式網域> 是您建立的網域名稱。

  6. 如果您要安裝應用程式而且您已經變更應用程式前置詞 (又稱為網站訂閱名稱),您必須執行與重新啟動主控應用程式之 World Wide Web Publishing 服務 (WWW 服務) 關聯的額外步驟。

    重要事項重要事項:
    重新啟動 WWW 服務也會重新啟動 IIS 系統管理服務與 Windows 處理序啟用服務,並且會關閉所有依賴這些服務的網站和應用程式。這可能會使它們遺失現有的狀態,要等成功重新啟動服務後才能再次使用。您應該規劃在計劃的維修時間執行這些步驟。
    若要完成應用程式前置詞重新命名工作,請執行這些步驟:
    1. 停止 SharePoint Timer Service。

    2. 重新啟動主控應用程式的 World Wide Web Publishing 服務。

    3. 啟動 SharePoint Timer Service。

如需詳細資訊,請參閱<Set-SPAppSiteSubscriptionName>及<Set-SPAppDomain>。

SharePoint 市集中包含搭配需要網際網路對向端點之網站使用的 SharePoint 應用程式。依預設,這些應用程式並無法使用 (灰階化無法購買),因為它們與大多數的網站都無法相容。不過,如果您伺服器陣列的設定允許網際網路對向端點,則您可開啟網際網路對向端點功能,以顯示 SharePoint 市集中的應用程式。您可在管理中心開啟此功能。

設定應用程式的網際網路對向端點
  1. 在管理中心中,按一下 [應用程式管理]。

  2. 在「應用程式管理」頁面上,按一下 [管理 Web 應用程式]。

  3. 在「管理 Web 應用程式」頁面上,選取要變更的 Web 應用程式。

  4. 在功能區上,按一下 [管理功能]。

  5. 在功能清單中,按一下 [需要可存取網際網路對向端點的應用程式] 旁的 [啟動]。

  6. 按一下 [確定]。

在某些情況下,例如,當您具有不常安裝更新的內部部署 SharePoint 2013 陣列時,您必須執行 Cmdlet 來更新用來指向 SharePoint 市集 的 URL:

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

顯示: