#summary (KnowledgeBase)New NS command introduces with MSNP18.
#labels Featured,msnp18,msnpsharp

= Introduction =

This is an document for NS command comes with MSNP18.
Thanks for our protocol researcher AUX who reverse engineered the USR SHA command.


= Details =

1. New USR command with SHA A parameters. This command is sent by client to get authority in new MSN group (circle) operation.

Example:

{{{
USR 30 SHA A PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTE2Ij8+CjxTaWduZWRUaW..[too long, omitted]..mVkVGlja2V0Pg==

}}}

The format of this command is USR _TransID_ SHA A _Nonce_

*TransID:* The transaction id of this NS message.

*Nonce:* A base64 string encoded from the field "CircleTicket" in the xml document returned by ABFindContactsPaged. The returned xml document of ABFindContactsPaged is something like this:

{{{

- <ABFindContactsPagedResponse xmlns="http://www.msn.com/webservices/AddressBook">
- <ABFindContactsPagedResult>
+ <Contacts>
- <CircleResult>
+ <Circles>
- <CircleInverseInfo>
- <Content>
- <Handle>
  <Id>00000000-0000-0000-0009-96c9144c6bc6</Id> 
  </Handle>
+ <Info>
  </Content>
+ <PersonalInfo>
  <Deleted>false</Deleted> 
  </CircleInverseInfo>
  </Circles>
  <CircleTicket><?xml version="1.0" encoding="utf-16"?> <SignedTicket xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" ver="1" keyVer="1"> <Data>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTE2Ij8+DQo8VGlja2V0IHhtbG5zOnhzaT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEtaW5zdGFuY2UiIHhtbG5zOnhzZD0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEiPg0KICA8Q2lyY2xlIElkPSIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwOS0wYjg0NmExNWUwMjEiIEhvc3RlZERvbWFpbj0ibGl2ZS5jb20iIC8+DQogIDxDaXJjbGUgSWQ9IjAwMDAwMDAwLTAwMDAtMDAwMC0wMDA5LTExMzMzMzBlNWVmYSIgSG9zdGVkRG9tYWluPSJsaXZlLmNvbSIgLz4NCiAgPENpcmNsZSBJZD0iMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDktNDJiODI5MTQxNTZjIiBIb3N0ZWREb21haW49ImxpdmUuY29tIiAvPg0KICA8Q2lyY2xlIElkPSIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwOS1kYmYzNzI5MzI1ZmMiIEhvc3RlZERvbWFpbj0ibGl2ZS5jb20iIC8+DQogIDxUUz4yMDA5LTA5LTE1VDEzOjIzOjIxLjAzNDY0NjdaPC9UUz4NCiAgPENJRD4yNjI4NzEzNzA2Mjg3OTcyMDk1PC9DSUQ+DQo8L1RpY2tldD4=</Data> <Sig>qa14qnW48CTxD7DphXZpj3eqFxyH/aURvJ2Ge6gbx8AJ9d0ByLeCBzWMaWCpmwsrbhVeLNDLEW8aVCCdZ4cFKoaMC/WHO8qmyl3Zis6yShljwGhVe0+kq98TL2KGSFSl4SFzu5p+reJCPtqSxWXp/14q581J7L2sBuEXyA1uxi0=</Sig> </SignedTicket></CircleTicket> 
  </CircleResult>
+ <Ab>
  </ABFindContactsPagedResult>
  </ABFindContactsPagedResponse>

}}}

Get the entire content of CircleTicket field, convert all the escaped character (For example: &lt; should be converted to <), then apply base64 on it, you will get the correct nonce.

You have to send this command once you successfully login, or you will get a NS server error if you want to send any message related to circle operation (Such as creating a circle, accepting join circle invitation, sending ADL and RML command to register circle users and so on).