Protocols/MSNP/XMPP - Revision history

Animadoria at 13:10, 11 May 2022

2022-05-11T13:10:12Z

← Older revision		Revision as of 13:10, 11 May 2022
Line 18:		Line 18:
	"Your app must support XMPP: Core functionality and, optionally, may implement the XMPP extensions we support."		"Your app must support XMPP: Core functionality and, optionally, may implement the XMPP extensions we support."

	= ~~Sign in~~ =		= Setting up =

	To connect to the Messenger XMPP service, either use Domain Name System (DNS) SRV records for messenger.live.com or connect directly to xmpp.messenger.live.com on port 5222.		To connect to the Messenger XMPP service, either use Domain Name System (DNS) SRV records for messenger.live.com or connect directly to xmpp.messenger.live.com on port 5222.
Line 28:		Line 28:
	We use X-MESSENGER-OAUTH2 Simple Authentication and Security Layer (SASL) authentication to get a user's okay, or consent, for your app to represent the user when signing in to the Messenger XMPP service. To do this, we use the OAuth 2.0 standard. To use our implementation, your app needs a client ID and an access token (and possibly other info, depending on your app type).		We use X-MESSENGER-OAUTH2 Simple Authentication and Security Layer (SASL) authentication to get a user's okay, or consent, for your app to represent the user when signing in to the Messenger XMPP service. To do this, we use the OAuth 2.0 standard. To use our implementation, your app needs a client ID and an access token (and possibly other info, depending on your app type).

	Sign in		= Sign in=

	After you have an access token, your app can sign in to the Messenger XMPP service on behalf of the consenting user.		After you have an access token, your app can sign in to the Messenger XMPP service on behalf of the consenting user.

Animadoria at 13:09, 11 May 2022

2022-05-11T13:09:25Z

← Older revision		Revision as of 13:09, 11 May 2022
Line 1:		Line 1:
	~~Convert from markdown:~~		{{Protocols/MSNP}}

	~~<pre>~~		Microsoft implemented a XMPP Gateway in the early 2010s. It was ultimately discontinued.
	~~Logs:~~

	~~https://forum~~.~~ag-software~~.~~net/thread/1382-How-to-convert-JID-into-Windows-Live-ID~~

	~~https://forum.ag-software.net/thread/1397-Issue-gmail-and-wlm-get-connect-but-not-show-cont;~~

	~~https://social.msdn.microsoft.com/Forums/SqlServer/en-US/f9e58e8b-3301-4018-acfa-60998b95d240/logs-of-xmpp-login-to-xmppmessengerlivecom?forum~~=~~messengerconnect~~		= Logs =

	https://forum.ag-software.net/thread/1406-Stack-Empty-Exception-after-successfully-login		* https://forum.ag-software.net/thread/1382-How-to-convert-JID-into-Windows-Live-ID
			* https://forum.ag-software.net/thread/1397-Issue-gmail-and-wlm-get-connect-but-not-show-cont;
			* https://social.msdn.microsoft.com/Forums/SqlServer/en-US/f9e58e8b-3301-4018-acfa-60998b95d240/logs-of-xmpp-login-to-xmppmessengerlivecom?forum=messengerconnect
			* https://forum.ag-software.net/thread/1406-Stack-Empty-Exception-after-successfully-login
			* https://forum.ag-software.net/thread/1255-Problems-with-using-X-MESSENGER-OAUTH2

	~~https://forum.ag-software.net/thread/1255-Problems-with-using-X-MESSENGER-OAUTH2~~		= Documentation =

	Documentation:		* https://blog.process-one.net/details_on_msns_xmpp_server/
			* <s>LiveSDK.zip</s> File lost

	~~https~~:~~//blog~~.~~process-one.net/details_on_msns_xmpp_server/~~		"Your app must support XMPP: Core functionality and, optionally, may implement the XMPP extensions we support."

	~~~~LiveSDK.zip~~ File lost~~		= Sign in =

	~~-----------------------~~

	~~Your app must support XMPP: Core functionality and, optionally, may implement the XMPP extensions we support.~~

	Prepare to sign in

	~~Before your app can sign in to the Messenger XMPP service, you need this info:~~

	To connect to the Messenger XMPP service, either use Domain Name System (DNS) SRV records for messenger.live.com or connect directly to xmpp.messenger.live.com on port 5222.		To connect to the Messenger XMPP service, either use Domain Name System (DNS) SRV records for messenger.live.com or connect directly to xmpp.messenger.live.com on port 5222.
Line 42:		Line 34:
	As stated in the previous section, the Messenger XMPP service uses X-MESSENGER-OAUTH2 SASL authentication. Your app sends the access token as the SASL token for authentication, as shown in the following partial exchange of protocol info, where ACCESS_TOKEN represents your access token.		As stated in the previous section, the Messenger XMPP service uses X-MESSENGER-OAUTH2 SASL authentication. Your app sends the access token as the SASL token for authentication, as shown in the following partial exchange of protocol info, where ACCESS_TOKEN represents your access token.

			<pre>
	< <stream:features xmlns:stream="http://etherx.jabber.org/streams"><mechanisms xmlns="urn:ietf:params:xml:ns:xmpp-sasl"><mechanism>X-MESSENGER-OAUTH2 </mechanism></mechanisms></stream:features>		< <stream:features xmlns:stream="http://etherx.jabber.org/streams"><mechanisms xmlns="urn:ietf:params:xml:ns:xmpp-sasl"><mechanism>X-MESSENGER-OAUTH2 </mechanism></mechanisms></stream:features>
	> <auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="X-MESSENGER-OAUTH2">ACCESS_TOKEN</auth>		> <auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="X-MESSENGER-OAUTH2">ACCESS_TOKEN</auth>
	< <success xmlns="urn:ietf:params:xml:ns:xmpp-sasl" />		< <success xmlns="urn:ietf:params:xml:ns:xmpp-sasl" />
			</pre>
	Remember that your code must first connect to the Messenger XMPP service by using DNS SRV records for messenger.live.com or by connecting directly to xmpp.messenger.live.com on port 5222.		Remember that your code must first connect to the Messenger XMPP service by using DNS SRV records for messenger.live.com or by connecting directly to xmpp.messenger.live.com on port 5222.

	Note The Messenger XMPP service uses the user ID in the access token to sign the user in and to bind the user to the session. To do this, Jabber IDs that are assigned by the Messenger XMPP service use the format identifier@messenger.live.com instead of a Microsoft account user ID.		Note: The Messenger XMPP service uses the user ID in the access token to sign the user in and to bind the user to the session. To do this, Jabber IDs that are assigned by the Messenger XMPP service use the format identifier@messenger.live.com instead of a Microsoft account user ID.

	Messenger XMPP reference		= Messenger XMPP reference =

	The Windows Live Messenger Extensible Messaging and Presence Protocol (XMPP) service supports only the following extensions, as defined by the XMPP Standards Foundation. Partial support for some extensions, as well as unique usage notes, are listed here. For more info, see [~~XMPP Standards Foundation - XMPP Extensions](~~http://go.microsoft.com/fwlink/p/?linkid=224453).		The Windows Live Messenger Extensible Messaging and Presence Protocol (XMPP) service supports only the following extensions, as defined by the XMPP Standards Foundation. Partial support for some extensions, as well as unique usage notes, are listed here. For more info, see [http://go.microsoft.com/fwlink/p/?linkid=224453 XMPP Standards Foundation - XMPP Extensions].

	[~~RFC6120](~~http://go.microsoft.com/fwlink/p/?linkid=224454): XMPP: Core		[http://go.microsoft.com/fwlink/p/?linkid=224454 RFC6120]: XMPP: Core

	[~~RFC6121](~~http://go.microsoft.com/fwlink/p/?linkid=224455): XMPP: Instant Messaging and Presence. Adding a contact is the only supported modifying operation; no other operations that modify the roster are supported. Chat is the only supported message stanza type. Presence probes are not supported.		[http://go.microsoft.com/fwlink/p/?linkid=224455 RFC6121]: XMPP: Instant Messaging and Presence. Adding a contact is the only supported modifying operation; no other operations that modify the roster are supported. Chat is the only supported message stanza type. Presence probes are not supported. Note Applications should cache most recent presence for buddies and should avoid signing out and signing in again as a way to refresh presence.
	Note Applications should cache most recent presence for buddies and should avoid signing out and signing in again as a way to refresh presence.

	[~~XEP-0054](~~http://go.microsoft.com/fwlink/p/?linkid=238258): vcard-temp. The Messenger XMPP service supports fetching vCards, but ~~doesn't~~ support updating vCards.		[http://go.microsoft.com/fwlink/p/?linkid=238258 XEP-0054]: vcard-temp. The Messenger XMPP service supports fetching vCards, but doesn’t support updating vCards.

	[~~XEP-0136](~~http://go.microsoft.com/fwlink/p/?linkid=238703): Message Archiving. Apps that implement this extension can request a certain number of instant messages that were previously exchanged between two users. Apps can currently request up to the last 10 instant messages, but this number is subject to change. Availability of these archived instant messages depends on whether at least one of the two users has the Automatically keep a history of my conversations setting turned on in Messenger. If no archived instant messages are available, the Messenger service returns an empty response.		[http://go.microsoft.com/fwlink/p/?linkid=238703 XEP-0136]: Message Archiving. Apps that implement this extension can request a certain number of instant messages that were previously exchanged between two users. Apps can currently request up to the last 10 instant messages, but this number is subject to change. Availability of these archived instant messages depends on whether at least one of the two users has the Automatically keep a history of my conversations setting turned on in Messenger. If no archived instant messages are available, the Messenger service returns an empty response. Note In requests for archived instant messages, the Messenger service ignores user endpoint requests, paging requests, and any uses of the after element.
	Note In requests for archived instant messages, the Messenger service ignores user endpoint requests, paging requests, and any uses of the after element.

	[~~XEP-0172](~~http://go.microsoft.com/fwlink/p/?linkid=238701): User Nickname. Apps can implement this extension to provide an improved user experience when showing pending contact invitations to the user. By default, contact invitations in XMPP are incoming subscriptions from users who ~~aren't~~ in the roster; these invitations provide only the pending ~~contact's~~ Jabber ID (JID), which ~~doesn't~~ show a display name. By implementing this extension, apps can retrieve the pending ~~contact's~~ display name so that Messenger users have a better idea of who the corresponding pending invitation is from. Note that it ~~isn't~~ necessary to support this extension for existing contacts, because their display names are available through their vCards. This extension is useful for pending contacts, because vCards are not available until after both parties have become contacts.		[http://go.microsoft.com/fwlink/p/?linkid=238701 XEP-0172]: User Nickname. Apps can implement this extension to provide an improved user experience when showing pending contact invitations to the user. By default, contact invitations in XMPP are incoming subscriptions from users who aren’t in the roster; these invitations provide only the pending contact’s Jabber ID (JID), which doesn’t show a display name. By implementing this extension, apps can retrieve the pending contact’s display name so that Messenger users have a better idea of who the corresponding pending invitation is from. Note that it isn’t necessary to support this extension for existing contacts, because their display names are available through their vCards. This extension is useful for pending contacts, because vCards are not available until after both parties have become contacts.

	[~~XEP-0203](~~http://go.microsoft.com/fwlink/p/?linkid=238260): Delayed Delivery		[http://go.microsoft.com/fwlink/p/?linkid=238260 XEP-0203]: Delayed Delivery

	Additional usage notes		= Additional usage notes =

	Adding Messenger buddies: To add a new Messenger buddy to the XMPP user's contact list, your app must add the buddy by using his or her Jabber ID (JID) and not by his or her Microsoft account ID. If your app does not add a buddy by using his or her JID, your app won't be able to display the buddy's presence info.		Adding Messenger buddies: To add a new Messenger buddy to the XMPP user's contact list, your app must add the buddy by using his or her Jabber ID (JID) and not by his or her Microsoft account ID. If your app does not add a buddy by using his or her JID, your app won't be able to display the buddy's presence info.
Line 75:		Line 65:
	Here's an example of submitting a Microsoft account ID to the Messenger XMPP service and retrieving the corresponding JID.		Here's an example of submitting a Microsoft account ID to the Messenger XMPP service and retrieving the corresponding JID.

			<pre>
	< <iq from='john@contoso.com' to='mary@contoso.com' type='get' id='id1'>		< <iq from='john@contoso.com' to='mary@contoso.com' type='get' id='id1'>
	<getjid xmlns='http://messenger.live.com/xmpp/jidlookup'></getjid>		<getjid xmlns='http://messenger.live.com/xmpp/jidlookup'></getjid>
Line 85:		Line 76:
	</iq>		</iq>
	</pre>		</pre>

			[[Category:MSN]]
			[[Category:Protocols/MSNP]]
			[[Category:Work_In_Progress]]

AD: Created page with "Convert from markdown:

 **Logs:**  https://forum.ag-software.net/thread/1382-How-to-convert-JID-into-Windows-Live-ID  https://forum.ag-software.net/thread/1397-Issue-gma..."

2021-03-13T05:22:26Z

Created page with "Convert from markdown: <pre> **Logs:** https://forum.ag-software.net/thread/1382-How-to-convert-JID-into-Windows-Live-ID https://forum.ag-software.net/thread/1397-Issue-gma..."

New page

Convert from markdown:

<pre>
**Logs:**

https://forum.ag-software.net/thread/1382-How-to-convert-JID-into-Windows-Live-ID

https://forum.ag-software.net/thread/1397-Issue-gmail-and-wlm-get-connect-but-not-show-cont;

https://social.msdn.microsoft.com/Forums/SqlServer/en-US/f9e58e8b-3301-4018-acfa-60998b95d240/logs-of-xmpp-login-to-xmppmessengerlivecom?forum=messengerconnect

https://forum.ag-software.net/thread/1406-Stack-Empty-Exception-after-successfully-login

https://forum.ag-software.net/thread/1255-Problems-with-using-X-MESSENGER-OAUTH2

**Documentation:**

https://blog.process-one.net/details_on_msns_xmpp_server/

~~LiveSDK.zip~~ File lost

-----------------------

Your app must support XMPP: Core functionality and, optionally, may implement the XMPP extensions we support.

**Prepare to sign in**

Before your app can sign in to the Messenger XMPP service, you need this info:

To connect to the Messenger XMPP service, either use Domain Name System (DNS) SRV records for messenger.live.com or connect directly to xmpp.messenger.live.com on port 5222.

Secure Sockets Layer (SSL) is required.

Your app must implement see-other-host. For details, see the "see-other-host" section in RFC6120: XMPP: Core.

We use X-MESSENGER-OAUTH2 Simple Authentication and Security Layer (SASL) authentication to get a user's okay, or consent, for your app to represent the user when signing in to the Messenger XMPP service. To do this, we use the OAuth 2.0 standard. To use our implementation, your app needs a client ID and an access token (and possibly other info, depending on your app type).

**Sign in**

After you have an access token, your app can sign in to the Messenger XMPP service on behalf of the consenting user.

As stated in the previous section, the Messenger XMPP service uses X-MESSENGER-OAUTH2 SASL authentication. Your app sends the access token as the SASL token for authentication, as shown in the following partial exchange of protocol info, where ACCESS_TOKEN represents your access token.

< <stream:features xmlns:stream="http://etherx.jabber.org/streams"><mechanisms xmlns="urn:ietf:params:xml:ns:xmpp-sasl"><mechanism>X-MESSENGER-OAUTH2 </mechanism></mechanisms></stream:features>
> <auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="X-MESSENGER-OAUTH2">ACCESS_TOKEN</auth>
< <success xmlns="urn:ietf:params:xml:ns:xmpp-sasl" />

Remember that your code must first connect to the Messenger XMPP service by using DNS SRV records for messenger.live.com or by connecting directly to xmpp.messenger.live.com on port 5222.

Note The Messenger XMPP service uses the user ID in the access token to sign the user in and to bind the user to the session. To do this, Jabber IDs that are assigned by the Messenger XMPP service use the format identifier@messenger.live.com instead of a Microsoft account user ID.

**Messenger XMPP reference**

The Windows Live Messenger Extensible Messaging and Presence Protocol (XMPP) service supports only the following extensions, as defined by the XMPP Standards Foundation. Partial support for some extensions, as well as unique usage notes, are listed here. For more info, see [XMPP Standards Foundation - XMPP Extensions](http://go.microsoft.com/fwlink/p/?linkid=224453).

[RFC6120](http://go.microsoft.com/fwlink/p/?linkid=224454): XMPP: Core

[RFC6121](http://go.microsoft.com/fwlink/p/?linkid=224455): XMPP: Instant Messaging and Presence. Adding a contact is the only supported modifying operation; no other operations that modify the roster are supported. Chat is the only supported message stanza type. Presence probes are not supported.
Note Applications should cache most recent presence for buddies and should avoid signing out and signing in again as a way to refresh presence.

[XEP-0054](http://go.microsoft.com/fwlink/p/?linkid=238258): vcard-temp. The Messenger XMPP service supports fetching vCards, but doesn't support updating vCards.

[XEP-0136](http://go.microsoft.com/fwlink/p/?linkid=238703): Message Archiving. Apps that implement this extension can request a certain number of instant messages that were previously exchanged between two users. Apps can currently request up to the last 10 instant messages, but this number is subject to change. Availability of these archived instant messages depends on whether at least one of the two users has the Automatically keep a history of my conversations setting turned on in Messenger. If no archived instant messages are available, the Messenger service returns an empty response.
Note In requests for archived instant messages, the Messenger service ignores user endpoint requests, paging requests, and any uses of the after element.

[XEP-0172](http://go.microsoft.com/fwlink/p/?linkid=238701): User Nickname. Apps can implement this extension to provide an improved user experience when showing pending contact invitations to the user. By default, contact invitations in XMPP are incoming subscriptions from users who aren't in the roster; these invitations provide only the pending contact's Jabber ID (JID), which doesn't show a display name. By implementing this extension, apps can retrieve the pending contact's display name so that Messenger users have a better idea of who the corresponding pending invitation is from. Note that it isn't necessary to support this extension for existing contacts, because their display names are available through their vCards. This extension is useful for pending contacts, because vCards are not available until after both parties have become contacts.

[XEP-0203](http://go.microsoft.com/fwlink/p/?linkid=238260): Delayed Delivery

**Additional usage notes**

Adding Messenger buddies: To add a new Messenger buddy to the XMPP user's contact list, your app must add the buddy by using his or her Jabber ID (JID) and not by his or her Microsoft account ID. If your app does not add a buddy by using his or her JID, your app won't be able to display the buddy's presence info.

Here's an example of submitting a Microsoft account ID to the Messenger XMPP service and retrieving the corresponding JID.

< <iq from='john@contoso.com' to='mary@contoso.com' type='get' id='id1'>
<getjid xmlns='http://messenger.live.com/xmpp/jidlookup'></getjid>
</iq>

> <iq from='john@contoso.com' to='mary@contoso.com' type='result' id='id1'>
<getjid xmlns='http://messenger.live.com/xmpp/jidlookup'>
<jid>12345@messenger.live.com</jid>
</getjid>
</iq>
</pre>