AD at 11:48, 26 March 2020

2020-03-26T11:48:35Z

← Older revision		Revision as of 11:48, 26 March 2020
Line 1:		Line 1:
	X		{{Protocols/WebAPI}}

			== AIM Start Page ==

			Supporting the AIM Start Page is one of the available choices for a client. A client that chooses this feature must keep a local preference per loginId if the start page should be shown or not. The preference must default to on for all loginIds.

			So the start page can be fully customized, we require authentication credentials to be passed using the [[Protocols/WebAPI/Single_Sign_On_to_Web_Pages\|Single Signon]] method described above. The client must show the start page to the user if they have not elected to turn it off.

			Showing the start page is a simple operation.

			# Form the start page URL following the instructions documented [[Protocols/WebAPI/Reference/Methods/Misc#aimStartPage\|here]].
			# Use the [[Protocols/WebAPI/Single_Sign_On_to_Web_Pages\|Single Signon]] method described to form the full signed URL for the browser.
			# Launch the browser with the full URL.

			== Expressions Requirement ==

			Both the ability to choose expressions from a web page and the ability to display at least Buddy icons is required. So the expression chooser can be fully customized, we require authentication credentials to be passed using the [[Protocols/WebAPI/Single_Sign_On_to_Web_Pages\|Single Signon]] method described above.

			Showing the expression chooser is simple.

			# Form the expressions URL following the instructions documented [[Protocols/WebAPI/Reference/Methods/Misc#aimExpressionsPage\|here]].
			# Use the [[Protocols/WebAPI/Single_Sign_On_to_Web_Pages\|Single Sign On]] method described to form the full signed URL for the browser.
			# Launch the browser with the full URL.

			== Connection Flow ==

			Displaying either the Start Page or the Expression Chooser using [[Protocols/WebAPI/Single_Sign_On_to_Web_Pages\|Single Sign On]] is almost exactly the same. For the example the start page is used, but it is easy to substitute the Expression Chooser.

			This PHP-based example a will use the same sessionKey and token as previous examples.

			<pre>
			$sessionKey = "wEOki901gedaIeJbMAy5k+hv4iJgfvshgM+cWtk+s1g=";

			$destUrl = uri_encode("http://api.oscar.nina.bz/aim/getStartPage?f=html&language;=en-us");

			$uri = "http://my.screenname.aol.com/_cqr/login/login.psp";

			$queryString = "a="
			. uri_encode("%2FwEAAAAAm3uC7kLggQUTUxDaptz5ddrYlsBinH5jBpi3aKVFOwRZUdy4VC3HBXkdtUaFOTM8E9og492eGQi3X0cIrwRfN5SsuA"
			. "%2BE9nGhXtbQt%2BHoaa8Fw9yMTuuuks3%2F8ZRh0IyGOaLWhQssgtB3vEoEEQPSc4ZZcUARXm0b3GBfEW5E3QGjTvi6tRPsVpmnfSQ%3D")
			. "&destUrl;=$destUrl"
			. "&devId;=thekey"
			. "&entryType;=client2Web"
			. "&ts;=203799990";
			</pre>

			$queryString's value with var_export() should be something like:
			<pre>
			"a=%252FwEAAAAAm3uC7kLggQUTUxDaptz5ddrYlsBinH5jBpi3aKVFOwRZUdy4VC3HBXkdtUaFOTM8E9og492eGQi3X0cIrwRfN5SsuA%252BE9nGhXtbQt%252BHoaa8Fw9yMTuuuks3%252F8ZRh0IyGOaLWhQssgtB3vEoEEQPSc4ZZcUARXm0b3GBfEW5E3QGjTvi6tRPsVpmnfSQ%253D&destUrl;=http%3A%2F%2Fapi.oscar.aol.com%2Faim%2FgetStartPage%3Ff%3Dhtml%26language%3Den-us&devId;=thekey&entryType;=client2Web&ts;=203799990"
			</pre>

			Combine:
			<pre>
			$hashData = "GET&" . uri_encode($uri) . "&" . uri_encode($queryString);
			</pre>

			The output of var_export() for $hashData should be something like:
			<pre>
			"GET&http;%3A%2F%2Fmy.screenname.aol.com%2F_cqr%2Flogin%2Flogin.psp&a;%3D%25252FwEAAAAAm3uC7kLggQUTUxDaptz5ddrYlsBinH5jBpi3aKVFOwRZUdy4VC3HBXkdtUaFOTM8E9og492eGQi3X0cIrwRfN5SsuA%25252BE9nGhXtbQt%25252BHoaa8Fw9yMTuuuks3%25252F8ZRh0IyGOaLWhQssgtB3vEoEEQPSc4ZZcUARXm0b3GBfEW5E3QGjTvi6tRPsVpmnfSQ%25253D%26destUrl%3Dhttp%253A%252F%252Fapi.oscar.aol.com%252Faim%252FgetStartPage%253Ff%253Dhtml%2526language%253Den-us%26devId%3Dthekey%26entryType%3Dclient2Web%26ts%3D203799990"
			</pre>

			Create a digest of the values above:
			<pre>
			$digest = hmac_sha256_base64($hashData, $sessionKey);
			= "8nMlPovQqriZyPvWbftEjz+lPnQRF5A8TDcU79raYc4="

			$url = $uri . "?" . $queryString . "&sig;_sha256=$digest";
			</pre>

			The output of var_export() for $url should be something like:
			<pre>
			"http://my.screenname.aol.com/_cqr/login/login.psp?a=%252FwEAAAAAm3uC7kLggQUTUxDaptz5ddrYlsBinH5jBpi3aKVFOwRZUdy4VC3HBXkdtUaFOTM8E9og492eGQi3X0cIrwRfN5SsuA%252BE9nGhXtbQt%252BHoaa8Fw9yMTuuuks3%252F8ZRh0IyGOaLWhQssgtB3vEoEEQPSc4ZZcUARXm0b3GBfEW5E3QGjTvi6tRPsVpmnfSQ%253D&destUrl;=http%3A%2F%2Fapi.oscar.aol.com%2Faim%2FgetStartPage%3Ff%3Dhtml%26language%3Den-us&devId;=thekey&entryType;=client2Web&ts;=203799990&sig;_sha256=8nMlPovQqriZyPvWbftEjz+lPnQRF5A8TDcU79raYc4"
			</pre>

			[[Category:Stub]]
			[[Category:AOL]]
			[[Category:AIM]]
			[[Category:Protocols/WebAPI]]
			[[Category:Protocols/WebAPI/Reference]]
			[[Category:Work_In_Progress]]

AD: Created page with "X"

2020-03-26T11:33:41Z

Created page with "X"

New page

Protocols/WebAPI/Start Page and Expression Chooser - Revision history

AD at 11:48, 26 March 2020

AD: Created page with "X"