Frameworks/libpurple.framework/Versions/0.6.2/Headers/nexus.h
author Zachary West <zacw@adium.im>
Fri Aug 21 13:25:11 2009 -0700 (2009-08-21)
changeset 2592 e8d15275025e
parent 1739 Frameworks/libpurple.framework/Versions/0.6.0/Headers/nexus.h@8b0daad9656c
permissions -rw-r--r--
im.pidgin.adium.1-4 at 267c6165e02e34318a1823960bd04c0639952f73
Evan@653
     1
/**
Evan@653
     2
 * @file nexus.h MSN Nexus functions
Evan@653
     3
 *
Evan@653
     4
 * purple
Evan@653
     5
 *
Evan@653
     6
 * Purple is the legal property of its developers, whose names are too numerous
Evan@653
     7
 * to list here.  Please refer to the COPYRIGHT file distributed with this
Evan@653
     8
 * source distribution.
Evan@653
     9
 *
Evan@653
    10
 * This program is free software; you can redistribute it and/or modify
Evan@653
    11
 * it under the terms of the GNU General Public License as published by
Evan@653
    12
 * the Free Software Foundation; either version 2 of the License, or
Evan@653
    13
 * (at your option) any later version.
Evan@653
    14
 *
Evan@653
    15
 * This program is distributed in the hope that it will be useful,
Evan@653
    16
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Evan@653
    17
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Evan@653
    18
 * GNU General Public License for more details.
Evan@653
    19
 *
Evan@653
    20
 * You should have received a copy of the GNU General Public License
Evan@653
    21
 * along with this program; if not, write to the Free Software
Evan@653
    22
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
Evan@653
    23
 */
Evan@653
    24
#ifndef _MSN_NEXUS_H_
Evan@653
    25
#define _MSN_NEXUS_H_
Evan@653
    26
Evan@653
    27
/* Index into ticket_tokens in nexus.c Keep updated! */
Evan@653
    28
typedef enum
Evan@653
    29
{
Evan@653
    30
	MSN_AUTH_MESSENGER     = 0,
Evan@653
    31
	MSN_AUTH_MESSENGER_WEB = 1,
Evan@653
    32
	MSN_AUTH_CONTACTS      = 2,
Evan@653
    33
	MSN_AUTH_LIVE_SECURE   = 3,
Evan@653
    34
	MSN_AUTH_SPACES        = 4,
Evan@653
    35
	MSN_AUTH_LIVE_CONTACTS = 5,
Evan@653
    36
	MSN_AUTH_STORAGE       = 6
Evan@653
    37
} MsnAuthDomains;
Evan@653
    38
Evan@653
    39
#define MSN_SSO_SERVER	"login.live.com"
Evan@653
    40
#define SSO_POST_URL	"/RST.srf"
Evan@653
    41
Evan@653
    42
#define MSN_SSO_RST_TEMPLATE \
Evan@653
    43
"<wst:RequestSecurityToken xmlns=\"http://schemas.xmlsoap.org/ws/2004/04/trust\" Id=\"RST%d\">"\
Evan@653
    44
	"<wst:RequestType>http://schemas.xmlsoap.org/ws/2004/04/security/trust/Issue</wst:RequestType>"\
Evan@653
    45
	"<wsp:AppliesTo xmlns=\"http://schemas.xmlsoap.org/ws/2002/12/policy\">"\
Evan@653
    46
		"<wsa:EndpointReference xmlns=\"http://schemas.xmlsoap.org/ws/2004/03/addressing\">"\
Evan@653
    47
			"<wsa:Address>%s</wsa:Address>"\
Evan@653
    48
		"</wsa:EndpointReference>"\
Evan@653
    49
	"</wsp:AppliesTo>"\
Evan@653
    50
	"<wsse:PolicyReference xmlns=\"http://schemas.xmlsoap.org/ws/2003/06/secext\" URI=\"%s\"></wsse:PolicyReference>"\
Evan@653
    51
"</wst:RequestSecurityToken>"
Evan@653
    52
Evan@653
    53
#define MSN_SSO_TEMPLATE "<?xml version='1.0' encoding='utf-8'?>"\
Evan@653
    54
"<Envelope xmlns=\"http://schemas.xmlsoap.org/soap/envelope/\""\
Evan@653
    55
	" xmlns:wsse=\"http://schemas.xmlsoap.org/ws/2003/06/secext\""\
Evan@653
    56
	" xmlns:saml=\"urn:oasis:names:tc:SAML:1.0:assertion\""\
Evan@653
    57
	" xmlns:wsp=\"http://schemas.xmlsoap.org/ws/2002/12/policy\""\
Evan@653
    58
	" xmlns:wsu=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd\""\
Evan@653
    59
	" xmlns:wsa=\"http://schemas.xmlsoap.org/ws/2004/03/addressing\""\
Evan@653
    60
	" xmlns:wssc=\"http://schemas.xmlsoap.org/ws/2004/04/sc\""\
Evan@653
    61
	" xmlns:wst=\"http://schemas.xmlsoap.org/ws/2004/04/trust\">"\
Evan@653
    62
	"<Header>"\
Evan@653
    63
		"<ps:AuthInfo"\
Evan@653
    64
			" xmlns:ps=\"http://schemas.microsoft.com/Passport/SoapServices/PPCRL\""\
Evan@653
    65
			" Id=\"PPAuthInfo\">"\
Evan@653
    66
			"<ps:HostingApp>{7108E71A-9926-4FCB-BCC9-9A9D3F32E423}</ps:HostingApp>"\
Evan@653
    67
			"<ps:BinaryVersion>4</ps:BinaryVersion>"\
Evan@653
    68
			"<ps:UIVersion>1</ps:UIVersion>"\
Evan@653
    69
			"<ps:Cookies></ps:Cookies>"\
Evan@653
    70
			"<ps:RequestParams>AQAAAAIAAABsYwQAAAAxMDMz</ps:RequestParams>"\
Evan@653
    71
		"</ps:AuthInfo>"\
Evan@653
    72
		"<wsse:Security>"\
Evan@653
    73
			"<wsse:UsernameToken Id=\"user\">"\
Evan@653
    74
				"<wsse:Username>%s</wsse:Username>"\
Evan@653
    75
				"<wsse:Password>%s</wsse:Password>"\
Evan@653
    76
			"</wsse:UsernameToken>"\
Evan@653
    77
		"</wsse:Security>"\
Evan@653
    78
	"</Header>"\
Evan@653
    79
	"<Body>"\
Evan@653
    80
		"<ps:RequestMultipleSecurityTokens"\
Evan@653
    81
			" xmlns:ps=\"http://schemas.microsoft.com/Passport/SoapServices/PPCRL\""\
Evan@653
    82
			" Id=\"RSTS\">"\
Evan@653
    83
			"<wst:RequestSecurityToken Id=\"RST0\">"\
Evan@653
    84
				"<wst:RequestType>http://schemas.xmlsoap.org/ws/2004/04/security/trust/Issue</wst:RequestType>"\
Evan@653
    85
				"<wsp:AppliesTo>"\
Evan@653
    86
					"<wsa:EndpointReference>"\
Evan@653
    87
						"<wsa:Address>http://Passport.NET/tb</wsa:Address>"\
Evan@653
    88
					"</wsa:EndpointReference>"\
Evan@653
    89
				"</wsp:AppliesTo>"\
Evan@653
    90
			"</wst:RequestSecurityToken>"\
Evan@653
    91
			"%s"	/* Other RSTn tokens */\
Evan@653
    92
		"</ps:RequestMultipleSecurityTokens>"\
Evan@653
    93
	"</Body>"\
Evan@653
    94
"</Envelope>"
Evan@653
    95
Evan@653
    96
#define MSN_SSO_AUTHINFO_TEMPLATE \
Evan@653
    97
"<ps:AuthInfo xmlns:ps=\"http://schemas.microsoft.com/Passport/SoapServices/PPCRL\" Id=\"PPAuthInfo\">"\
Evan@653
    98
	"<ps:HostingApp>{7108E71A-9926-4FCB-BCC9-9A9D3F32E423}</ps:HostingApp>"\
Evan@653
    99
	"<ps:BinaryVersion>4</ps:BinaryVersion>"\
Evan@653
   100
	"<ps:UIVersion>1</ps:UIVersion>"\
Evan@653
   101
	"<ps:Cookies></ps:Cookies>"\
Evan@653
   102
	"<ps:RequestParams>AQAAAAIAAABsYwQAAAA0MTA1</ps:RequestParams>"\
Evan@653
   103
"</ps:AuthInfo>"
Evan@653
   104
/* Not sure what's editable here, so I'll just hard-code the SHA1 hash */
Evan@653
   105
#define MSN_SSO_AUTHINFO_SHA1_BASE64 "d2IeTF4DAkPEa/tVETHznsivEpc="
Evan@653
   106
Evan@653
   107
#define MSN_SSO_TIMESTAMP_TEMPLATE \
Evan@653
   108
"<wsu:Timestamp xmlns=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd\" Id=\"Timestamp\">"\
Evan@653
   109
	"<wsu:Created>%s</wsu:Created>"\
Evan@653
   110
	"<wsu:Expires>%s</wsu:Expires>"\
Evan@653
   111
"</wsu:Timestamp>"
Evan@653
   112
Evan@653
   113
#define MSN_SSO_SIGNEDINFO_TEMPLATE \
Evan@653
   114
"<SignedInfo xmlns=\"http://www.w3.org/2000/09/xmldsig#\">"\
Evan@653
   115
	"<CanonicalizationMethod Algorithm=\"http://www.w3.org/2001/10/xml-exc-c14n#\"></CanonicalizationMethod>"\
Evan@653
   116
	"<SignatureMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#hmac-sha1\"></SignatureMethod>"\
Evan@653
   117
	"<Reference URI=\"#RST%d\">"\
Evan@653
   118
		"<Transforms>"\
Evan@653
   119
			"<Transform Algorithm=\"http://www.w3.org/2001/10/xml-exc-c14n#\"></Transform>"\
Evan@653
   120
		"</Transforms>"\
Evan@653
   121
		"<DigestMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#sha1\"></DigestMethod>"\
Evan@653
   122
		"<DigestValue>%s</DigestValue>"\
Evan@653
   123
	"</Reference>"\
Evan@653
   124
	"<Reference URI=\"#Timestamp\">"\
Evan@653
   125
		"<Transforms>"\
Evan@653
   126
			"<Transform Algorithm=\"http://www.w3.org/2001/10/xml-exc-c14n#\"></Transform>"\
Evan@653
   127
		"</Transforms>"\
Evan@653
   128
		"<DigestMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#sha1\"></DigestMethod>"\
Evan@653
   129
		"<DigestValue>%s</DigestValue>"\
Evan@653
   130
	"</Reference>"\
Evan@653
   131
	"<Reference URI=\"#PPAuthInfo\">"\
Evan@653
   132
		"<Transforms>"\
Evan@653
   133
			"<Transform Algorithm=\"http://www.w3.org/2001/10/xml-exc-c14n#\"></Transform>"\
Evan@653
   134
		"</Transforms>"\
Evan@653
   135
		"<DigestMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#sha1\"></DigestMethod>"\
Evan@653
   136
		"<DigestValue>" MSN_SSO_AUTHINFO_SHA1_BASE64 "</DigestValue>"\
Evan@653
   137
	"</Reference>"\
Evan@653
   138
"</SignedInfo>"
Evan@653
   139
Evan@653
   140
#define MSN_SSO_TOKEN_UPDATE_TEMPLATE "<?xml version=\"1.0\" encoding=\"utf-8\"?>"\
Evan@653
   141
"<Envelope"\
Evan@653
   142
	" xmlns=\"http://schemas.xmlsoap.org/soap/envelope/\""\
Evan@653
   143
	" xmlns:wsse=\"http://schemas.xmlsoap.org/ws/2003/06/secext\""\
Evan@653
   144
	" xmlns:saml=\"urn:oasis:names:tc:SAML:1.0:assertion\""\
Evan@653
   145
	" xmlns:wsp=\"http://schemas.xmlsoap.org/ws/2002/12/policy\""\
Evan@653
   146
	" xmlns:wsu=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd\""\
Evan@653
   147
	" xmlns:wsa=\"http://schemas.xmlsoap.org/ws/2004/03/addressing\""\
Evan@653
   148
	" xmlns:wssc=\"http://schemas.xmlsoap.org/ws/2004/04/sc\""\
Evan@653
   149
	" xmlns:wst=\"http://schemas.xmlsoap.org/ws/2004/04/trust\">"\
Evan@653
   150
	"<Header>"\
Evan@653
   151
		MSN_SSO_AUTHINFO_TEMPLATE /* ps:AuthInfo */ \
Evan@653
   152
		"<wsse:Security>"\
Evan@653
   153
			"<EncryptedData xmlns=\"http://www.w3.org/2001/04/xmlenc#\" Id=\"BinaryDAToken0\" Type=\"http://www.w3.org/2001/04/xmlenc#Element\">"\
Evan@653
   154
				"<EncryptionMethod Algorithm=\"http://www.w3.org/2001/04/xmlenc#tripledes-cbc\"></EncryptionMethod>"\
Evan@653
   155
				"<ds:KeyInfo xmlns:ds=\"http://www.w3.org/2000/09/xmldsig#\">"\
Evan@653
   156
					"<ds:KeyName>http://Passport.NET/STS</ds:KeyName>"\
Evan@653
   157
				"</ds:KeyInfo>"\
Evan@653
   158
				"<CipherData>"\
Evan@653
   159
					"<CipherValue>%s</CipherValue>"\
Evan@653
   160
				"</CipherData>"\
Evan@653
   161
			"</EncryptedData>"\
Evan@653
   162
			"<wssc:DerivedKeyToken Id=\"SignKey\">"\
Evan@653
   163
				"<wsse:RequestedTokenReference>"\
Evan@653
   164
					"<wsse:KeyIdentifier ValueType=\"http://docs.oasis-open.org/wss/2004/XX/oasis-2004XX-wss-saml-token-profile-1.0#SAMLAssertionID\" />"\
Evan@653
   165
					"<wsse:Reference URI=\"#BinaryDAToken0\" />"\
Evan@653
   166
				"</wsse:RequestedTokenReference>"\
Evan@653
   167
				"<wssc:Nonce>%s</wssc:Nonce>"\
Evan@653
   168
			"</wssc:DerivedKeyToken>"\
Evan@653
   169
			"%s" /* wsu:Timestamp */\
Evan@653
   170
			"<Signature xmlns=\"http://www.w3.org/2000/09/xmldsig#\">"\
Evan@653
   171
				"%s" /* SignedInfo */\
Evan@653
   172
				"<SignatureValue>%s</SignatureValue>"\
Evan@653
   173
				"<KeyInfo>"\
Evan@653
   174
					"<wsse:SecurityTokenReference>"\
Evan@653
   175
						"<wsse:Reference URI=\"#SignKey\" />"\
Evan@653
   176
					"</wsse:SecurityTokenReference>"\
Evan@653
   177
				"</KeyInfo>"\
Evan@653
   178
			"</Signature>"\
Evan@653
   179
		"</wsse:Security>"\
Evan@653
   180
	"</Header>"\
Evan@653
   181
	"<Body>"\
Evan@653
   182
		"%s" /* wst:RequestSecurityToken */ \
Evan@653
   183
	"</Body>"\
Evan@653
   184
"</Envelope>"
Evan@653
   185
Evan@653
   186
typedef struct _MsnUsrKey MsnUsrKey;
Evan@653
   187
struct _MsnUsrKey
Evan@653
   188
{
Evan@653
   189
	int size; /* 28. Does not count data */
Evan@653
   190
	int crypt_mode; /* CRYPT_MODE_CBC (1) */
Evan@653
   191
	int cipher_type; /* TripleDES (0x6603) */
Evan@653
   192
	int hash_type; /* SHA1 (0x8004) */
Evan@653
   193
	int iv_len;    /* 8 */
Evan@653
   194
	int hash_len;  /* 20 */
Evan@653
   195
	int cipher_len; /* 72 */
Evan@653
   196
	/* Data */
Evan@653
   197
	char iv[8];
Evan@653
   198
	char hash[20];
Evan@653
   199
	char cipher[72];
Evan@653
   200
};
Evan@653
   201
Evan@653
   202
typedef struct _MsnTicketToken MsnTicketToken;
Evan@653
   203
struct _MsnTicketToken {
Evan@653
   204
	GHashTable *token;
Evan@653
   205
	char *secret;
Evan@653
   206
	time_t expiry;
Evan@770
   207
	GSList *updates;
Evan@653
   208
};
Evan@653
   209
Evan@653
   210
typedef struct _MsnNexus MsnNexus;
Evan@653
   211
Evan@653
   212
struct _MsnNexus
Evan@653
   213
{
Evan@653
   214
	MsnSession *session;
Evan@653
   215
Evan@653
   216
	/* From server via USR command */
Evan@653
   217
	char *policy;
Evan@653
   218
	char *nonce;
Evan@653
   219
Evan@653
   220
	/* From server via SOAP stuff */
Evan@653
   221
	char *cipher;
Evan@653
   222
	char *secret;
Evan@653
   223
	MsnTicketToken *tokens;
Evan@653
   224
	int token_len;
Evan@653
   225
};
Evan@653
   226
Evan@653
   227
void msn_nexus_connect(MsnNexus *nexus);
Evan@653
   228
MsnNexus *msn_nexus_new(MsnSession *session);
Evan@653
   229
void msn_nexus_destroy(MsnNexus *nexus);
Evan@653
   230
GHashTable *msn_nexus_get_token(MsnNexus *nexus, MsnAuthDomains id);
Evan@653
   231
const char *msn_nexus_get_token_str(MsnNexus *nexus, MsnAuthDomains id);
Evan@653
   232
void msn_nexus_update_token(MsnNexus *nexus, int id, GSourceFunc cb, gpointer data);
Evan@653
   233
#endif /* _MSN_NEXUS_H_ */
Evan@653
   234