今年中下旬微软公布了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 ...

posted on 2006-11-30 01:48  维生素C.NET  阅读(1644)  评论(1编辑  收藏  举报