Applied Windows Live Custom Domains (2) – SDK簡介

今年中下旬微軟公布了Windows Live Custom Domains的SDK。在上一篇對Windows Live Custom Domains的簡單介紹的文章中我們看到了幾張其網站操作介面的，擷取有一些讀者看過後也已經申請註冊了自己的Windows Live Custom Domain了。但是對於中小企業來說，該SDK是非常有用的。

Windows Live Custom Domains SDK除了能完成我們在web介面上可操作的功能外還增加了對使用者列表的匯出和匯入，而這兩個重要的功能是在web操作介面上所沒有的，但卻是企業使用者所需要的。

Windows Live Custom Domains SDK使用SOAP RPC 1.1標準來完成用戶端程式和Windows Live Custom Domains web伺服器提供的Web Services的互動，SDK裡有關於每個方法的SOAP調用的詳細說明文檔。需要注意的是SDK不能作的是不能註冊custom domain的服務和取消該服務。

SDK中附帶兩個Sample,一個是Console的,另一個是Win32 app的.

在進行任何的操作方法調用前,我們首先要做的是登陸認證。所有的串連到web服務的connection都需要使用者已經登陸到Passwork Network中。該web services和Windows Live Custom Domains使用的是相同的使用者認證，就是Microsoft Passport service，我們將在後面的sample分析中做稍微詳細一點的說明。但是需要注意的是使用文字格式設定明文儲存登陸票據是非常危險的。

SDK中提供的方法：

• AddUser
• DeleteUser
• GetUserState 根據使用者名稱返回您的域下的該使用者的狀態
• EnumUsers 列出當前域所有的使用者
• EvictSquatter 如果您在使用windows live custom domain之前您的域下某使用者已經存在了（這樣的使用者稱為EASI，即E-mail as sign-in only，電子郵件地址僅用來作為登陸到passport之用，與hotmail是沒有關係的），那麼您除了可以通過匯入的方式將其所有設定（包括密碼）隨即轉移外還可以通過該功能棄用此使用者，目的是建立同一名稱的新使用者。而棄用某使用者將強制其在下次登入時必須重新命名其帳戶。他們將保留其 Windows Live ID 設定，但帳戶名稱將被更改。提示：所有發送到非使用中收件匣的電子郵件將被退回並顯示為無法傳遞的。若要啟用其收件匣，您的使用者必須使用您為其建立的使用者名稱和臨時密碼登入
• ImportUser  匯入一個已經存在的EASI passport使用者到該域中。
• EnumDomains 返回當前登陸管理使用者所管理的所有域的名字
• GetDomainState 返回當前域的狀態

提供的Console模式的Sample支援以下功能：

• 增加、刪除和枚舉使用者
• 判斷一個使用者是否已經在該域內
• 通過從.csv檔案中匯入使用者名來大量新增新使用者
• 枚舉一個已經登陸的管理使用者所管理的域

而SDK提供的Win32 Sample提供了良好的GUI支援，在支援Console Sample中功能的同時有一個更改和一個新功能的添加：

• 從一個.xml中大量匯入使用者
• 將使用者匯出至一個.xml檔案（匯入和匯出使用相同的格式）

To Be Continued ...