w7 APPLICATION CSP

APPID 為 w7 的應用程式組組服務提供者,用於使用 OMA DM 帳戶引導裝置。 雖然此設定服務提供者是用來設定 OMA DM 帳戶,但它是由 OMA 用戶端設定所管理。

注意 此組配置服務提供者需要 ID_CAP_CSP_FOUNDATION 和 ID_CAP_DEVICE_MANAGEMENT_ADMIN 功能,以從網路組組應用程式存取。

下列以樹狀格式顯示 OMA 用戶端資源調配所使用的組狀服務提供者。

APPLICATION
---APPADDR
------ADDR
------ADDRTYPE
------PORT
---------PORTNBR
---APPAUTH
------AAUTHDATA
------AAUTHLEVEL
------AAUTHNAME
------AAUTHSECRET
------AAUTHTYPE
---AppID
---BACKCOMPATRETRYDISABLED
---CONNRETRYFREQ
---DEFAULTENCODING
---INIT
---INITIALBACKOFTIME
---MAXBACKOFTIME
---NAME
---PROTOVER
---PROVIDER-ID
---ROLE 
---TO-NAPID
---USEHWDEVID
---SSLCLIENTCERTSEARCHCRITERIA

注意 所有 parm 名稱和特性類型都是區分大小寫的,而且必須使用所有大寫。 在配置 XML 時,必須同時提供 APPSRV 和 CLIENT 認證。

APPADDR
此特性用於 w7 APPLICATION 特性,以指定 DM 伺服器位址。

APPADDR/ADDR
選用。 ADDR 參數用於 APPADDR 特性,以取得或設定 OMA DM 伺服器的位址。 此參數接受字串值。

APPADDR/ADDRTYPE
選用。 ADDRTYPE 參數用於 APPADDR 特性,以取得或設定 ADDR 參數的格式。 此參數接受字串值。

在 OMA DM XML 中,如果有多個此參數實例,會使用第一個有效參數值。

APPADDR/PORT
此特性用於 APPADDR 特性以指定埠資訊。

APPADDR/PORT/PORTNBR
必要。 PORTNBR 參數用於埠特性,以取得或設定要連接的埠數目。 此參數採用字串格式的數值。

APPAUTH
此特性用於 w7 APPLICATION 特性,以指定驗證資訊。

APPAUTH/AAUTHDATA
選用。 AAUTHDATA 參數用於 APPAUTH 特性,以取得或設定驗證中使用的其他資料。 此參數是用來傳達摘要驗證類型的非參數。 此參數接受字串值。 此參數的值是一個以數個位元組形式編碼的 base64。 請注意,如果 AAUTHTYPE 是 DIGEST,這會在 MD5 雜湊計算中做為非數值,而計算伺服器端和裝置端雜湊時,應該使用二進位資料的八進位形式。

APPAUTH/AAUTHLEVEL
必要。 AAUTHLEVEL 參數用於 APPAUTH 特性,指出認證是伺服器驗證還是用戶端驗證。 此參數接受字串值。 您可以設定此值。

有效值:

  • APPSRV - 指定用戶端在 DM 通訊協定層級向 OMA DM Server 進行驗證。

  • CLIENT - 指定伺服器會向 DM 通訊協定層級的 OMA DM Client 進行自我驗證。

APPAUTH/AAUTHNAME
選用。 AAUTHNAME 參數用於 APPAUTH 特性,以區分 OMA DM 用戶端名稱。 此參數接受字串值。 您可以設定此值。

APPAUTH/AAUTHSECRET
必要。 AAUTHSECRET 參數用於 APPAUTH 特性中,以取得或設定用來驗證使用者的驗證密碼。 此參數接受字串值。

APPAUTH/AAUTHTYPE
選用。 APPAUTH 特性的 AAUTHTYPE 參數是用來取得或設定驗證方法。 此參數接受字串值。

有效值:

  • BASIC - 指定 SyncML DM 'syncml:auth-basic' 驗證類型。

  • DIGEST - 指定 SyncML DM'syncml:auth-md5' 驗證類型。

  • 當 AAUTHLEVEL 是用戶端時,AAUTHTYPE 必須是摘要。 當 AAUTHLEVEL 是 APPSRV 時,AAUTHTYPE 可以是基本或摘要。

APPID
必要。 APPID 參數用於 APPLICATION 特性,以區分可用的應用程式服務和通訊協定類型。 此參數接受字串值。 您可以取得或設定此值。 設定 OMA 用戶端部署開機自舉 APPID 的唯一有效值是 w7。

BACKCOMPATRETRYDISABLED
選用。 BACKCOMPATRETRYDISABLED 參數用於應用程式特性,指定是否要嘗試使用舊版通訊協定版本 (重新發送套件,例如 SyncHdr (中的 1.1) (不包括第一次) 。

注意 此參數不包含值。 此參數的存在表示已停用向後相容性重試。 如果參數遺失,表示已啟用向後相容性重試。

CONNRETRYFREQ
選用。 CONNRETRYFREQ 參數用於 APPLICATION 特性,指定當有連接管理員層級或 WinInet 層級錯誤時,DM 用戶端執行的重試數。 此參數採用字串格式的數值。 預設值為"3"。 您可以設定此參數。

DEFAULTENCODING
選用。 DEFAULTENCODING 參數用於 APPLICATION 特性中,指定 DM 用戶端在與伺服器通訊時,是否應該在 DM 套件中使用 WBXML 或 XML。 您可以取得或設定此參數。

有效的值為:

  • application/vnd.syncml.dm+xml (預設)

  • application/vnd.syncml.dm+wbxml

INIT
選用。 INIT 參數用於 APPLICATION 特性,表示管理伺服器希望用戶端在設定核准後立即啟動管理會話。 如果目前的 w7 APPLICATION 檔會放在 ROM 中,則 INIT 參數不得存在。

注意 此節點僅適用于嘗試使用此節點的電信業者與 MDM 伺服器,將會失敗。 企業 MDM 註冊案例不支援此節點。 此參數會強制裝置嘗試與 OMA DM 伺服器連接。 如果 XML 是在 coldinit 階段設定,則連接嘗試會失敗。 造成此失敗之常見原因是,當 coldinit 完成之後,收音機尚未準備就緒。

INITIALBACKOFFTIME
選用。 INITIALBACKOFFTIME 參數用於 APPLICATION 特性中,以毫秒為單位指定 DM 用戶端第一次重試時的初始等待時間。 等待時間會以指數方式增加。 此參數採用字串格式的數值。 預設值為"16000"。 您可以取得或設定此參數。

MAXBACKOFFTIME
選用。 MAXBACKOFFTIME 參數用於應用程式特性,指定封裝傳送失敗後要睡眠的最大毫秒數。 此參數採用字串格式的數值。 預設值為「86400000」。 您可以設定此參數。

NAME
選用。 NAME 參數用於應用程式特性,以指定使用者可讀取的應用程式身分識別。 此參數用於定義 APPLICATION 參數的一部分註冊表路徑。 您可以設定此參數。

NAME 參數可以是字串或 null, (值) 。 如果未指定值,則註冊表位置會預設為 < 未命名 > 。

PROTOVER
選用。 PROTOVER 參數用於 APPLICATION 特性,以指定伺服器支援的 OMA DM 通訊協定版本。 不會假設預設值。 此節點所設定通訊協定版本會符合 DM 用戶端在套件 1 中的 SyncHdr 中向伺服器報告通訊協定版本。 如果新增 DM 伺服器帳戶時未指定此節點,會使用用戶端支援的最新 DM 通訊協定版本。 在 Windows Phone中,這是 1.2。 這是 Microsoft 自訂參數。 您可以設定此參數。

可能的值:

  • 1.1

  • 1.2

PROVIDER-ID
選用。 PROVIDER-ID 參數用於 APPLICATION 特性,以區分 OMA DM 伺服器。 它會指定目前管理會話中使用的管理伺服器伺服器識別碼。 此參數接受字串值。 您可以設定此參數。

作用
選用。 ROLE 參數用於 APPLICATION 特性中,指定 DM 會話在與 DM 伺服器通訊時應該用來執行的安全性應用程式室。 唯一支援的角色是 8 () ,以及 32 (企業) 。 如果不存在此參數,則假設為行動運算子角色。 企業角色只能由企業註冊用戶端設定。 企業用戶端無法設定行動運算子角色。 這是 Microsoft 自訂參數。 此參數採用字串格式的數值。 您可以取得或設定此參數。

TO-NAPID
選用。 TO-NAPID 參數用於應用程式特性,以指定用戶端將用來連接到 OMA DM 伺服器的網路訪問點。 如果指定多個 TO-NAPID 參數,則只會儲存第一個 TO-NAPID 值。 此參數接受字串值。 您可以設定此參數。

USEHWDEVID
選用。 USEHWDEVID 參數用於 APPLICATION 特性,以指定裝置硬體識別的使用。 沒有值。

  • 如果參數不存在,預設行為是使用應用程式特定的 GUID,而不是硬體裝置識別碼。

  • 如果參數存在,硬體裝置識別碼會提供于 ./DevInfo/DevID 節點,以及寄往伺服器的 DM 套件的 Source LocURI 中。 IMEI 裝置會 (IMEI) 國際行動使用者身分識別。

SSLCLIENTCERTSEARCHCRITERIA
選用。 SSLCLIENTCERTSEARCHCRITERIA 參數用於 APPLICATION 特性,以指定用戶端憑證搜尋準則。 此參數支援按主體屬性和憑證存放區搜尋。 如果提供任何其他準則,則忽略該準則。

字串是名稱/值對的串連,該組的每一個成員都由 "&" 字元分隔。 名稱和值會以 "=" 字元分隔。 如果有多個值,則每個值會以 Unicode 字元 "U+F000" 分隔。 如果名稱或值包含的不是 RFC2396 (中指定的 UNRESERVED 集) ,則這些字元會根據 RFC 以 URI 逸出。

支援的名稱為 Subject 和 Store;萬用字元憑證搜尋不受支援。

Stores 會指定DM 用戶端會搜尋哪些憑證來尋找 SSL 用戶端憑證。 有效的市面值為 My%5CUser。 市/市名稱不區分大小寫。

請注意 %EF%80%80 是 UTF8 編碼字元 U+F000。

Subject 會指定要搜尋的憑證。 例如,若要指定您想要具有特定 Subject 屬性的憑證 ("CN=測試人員,O=Microsoft") ,請使用下列方法:

<parm name="SSLCLIENTCERTSEARCHCRITERIA" 
   value="Subject=CN%3DTester,O%3DMicrosoft&amp;Stores=My%5CUser" />

相關主題

設定服務提供者參考