Smart Card - Revision history

Wtv-411: Completely overhaul smart card page - write more proper documentation on version 2 format and WTVP side, and add client command for writing to smart cards

2023-08-05T20:53:30Z

Completely overhaul smart card page - write more proper documentation on version 2 format and WTVP side, and add client command for writing to smart cards

Show changes

Wtv-411: Start rewriting smart card page

2023-08-04T22:48:54Z

Start rewriting smart card page

← Older revision		Revision as of 18:48, 4 August 2023
Line 1:		Line 1:
	{{WTVPNav}}		{{WTVPNav}}

	Smart Cards were used on the first-generation ~~WebTV/~~MSN TV service to take the user to a site, set up ISP options, etc. They were rarely utilized, and removed ~~from MSNTV~~ 2 ~~later~~.		Smart Cards were used on the WebTV and first-generation MSN TV service to take the user to a site, set up ISP options, etc. They were rarely utilized, and removed by the time the MSN TV 2 released.

	== ~~Overview~~ ==		== Service Side ==
	When a ~~Smart Card~~ is inserted into the WebTV/MSN TV receiver, it will show a message on the screen with the ~~Smart Card~~ name and a progress bar. In the background, ~~it's contacting~~ the URL from the <code>wtv-smartcard-inserted-url</code> header, which is usually <code>wtv-smartcard:/insert</code>. The box will POST the raw data read from the card to the URL ~~(sometimes the box will base64 encode~~ the data, ~~but~~ the ~~reasoning for this is unknown), which will then decode it and return either~~ a ~~wtv-smartcard page~~ with ~~an error/confirmation page, or a redirect to somewhere else. In some cases, the box will send an error header (e.g~~: ~~"error=-68") if something goes wrong.~~		When a smart card is inserted into the WebTV/MSN TV receiver, it will show a message on the screen with the smart card name and a progress bar. In the background, the box will contact the URL from the <code>wtv-smartcard-inserted-url</code> header sent from headwaiter, which is usually <code>wtv-smartcard:/insert</code>. The box will <code>POST</code> the raw data read from the card to the URL. While official clients can supposedly send the smart card data raw, it has only been documented to send the data as a Base64 encoded string with every 4 bytes swapped:

	== Structure ==		<pre>
			POST wtv-smartcard:/insert\r\n
			User-Agent: Mozilla/4.0 WebTV/2.6 (compatible; MSIE 4.0)\r\n
			wtv-show-time-record: 4 <wtv-home:/home?>\r\n
			wtv-request-type: primary\r\n
			wtv-incarnation: 14\r\n
			Content-type: application/octet-stream\r\n
			Content-length: 36\r\n
			\r\n
			/fkMTtAd552bhZFIlVHbHcEI5kTa5kTO==QO
			</pre>

			The server will unswap the bytes, decode the data into its raw binary form, and then parse it as smart card data to determine what to do with it. While the specifics of the <code>wtv-smartcard</code> aren't well known, what is known is that the server will redirect the box to the website if the smart card data is for a "Go To" card and send an error page is the data is invalid.

			In some cases, the box will send an error header (e.g: "error=-68") if something goes wrong.

			== Data Structure ==
			<!-- TODO: Redo this entire section to be less sucky - add proper technical info on smart card format and discuss more types -->
	For now, we'll be focusing on Go To cards, as that's what we have info on.		For now, we'll be focusing on Go To cards, as that's what we have info on.

Wtv-411: Add WTVP sidebar

2023-07-02T16:17:28Z

Add WTVP sidebar

← Older revision		Revision as of 12:17, 2 July 2023
Line 1:		Line 1:
			{{WTVPNav}}

	Smart Cards were used on the first-generation WebTV/MSN TV service to take the user to a site, set up ISP options, etc. They were rarely utilized, and removed from MSNTV 2 later.		Smart Cards were used on the first-generation WebTV/MSN TV service to take the user to a site, set up ISP options, etc. They were rarely utilized, and removed from MSNTV 2 later.

JarHead: /* Overview */

2023-01-09T02:57:11Z

Overview

← Older revision		Revision as of 22:57, 8 January 2023
Line 2:		Line 2:

	== Overview ==		== Overview ==
	When a Smart Card is inserted into the WebTV/MSN TV receiver, it will show a message on the screen with the Smart Card name and a progress bar. In the background, it's contacting the URL from the <code>wtv-smartcard-inserted-url</code> header, which is usually <code>wtv-smartcard:/insert</code>. The box will POST the raw data read from the card to the URL (sometimes the box will base64 encode the data, but the reasoning for this is unknown), which will then decode it and return either a wtv-smartcard page with an error/confirmation page, or a redirect to somewhere else. In some cases, the box will send an error header (e.g: "error="-68") if something goes wrong.		When a Smart Card is inserted into the WebTV/MSN TV receiver, it will show a message on the screen with the Smart Card name and a progress bar. In the background, it's contacting the URL from the <code>wtv-smartcard-inserted-url</code> header, which is usually <code>wtv-smartcard:/insert</code>. The box will POST the raw data read from the card to the URL (sometimes the box will base64 encode the data, but the reasoning for this is unknown), which will then decode it and return either a wtv-smartcard page with an error/confirmation page, or a redirect to somewhere else. In some cases, the box will send an error header (e.g: "error=-68") if something goes wrong.

	== Structure ==		== Structure ==

JarHead at 15:43, 12 September 2022

2022-09-12T15:43:07Z

← Older revision		Revision as of 11:43, 12 September 2022
Line 12:		Line 12:
	We can break this data up into several parts to get all the data that the server decodes.		We can break this data up into several parts to get all the data that the server decodes.

	The first byte is the Smart Card generation, which appears to always be 2 except for a special type of Go To card, which uses generation 1. "Generation" is assumed to refer to the data format for the card.		The first byte is the Smart Card generation, which appears to always be 2 except for a special type of Go To card, which uses generation 1. "Generation" is assumed to refer to the data format for the card, not a different version of Smart Cards themselves.

	The second byte is the Smart Card type, which is (G)o To in this case. Other observed values include (O)penISP and (A)ffinity.		The second byte is the Smart Card type, which is (G)o To in this case. Other observed values include (O)penISP and (A)ffinity.

JarHead: Smart Card

2022-09-12T15:41:32Z

Smart Card

New page

Smart Cards were used on the first-generation WebTV/MSN TV service to take the user to a site, set up ISP options, etc. They were rarely utilized, and removed from MSNTV 2 later.

== Overview ==
When a Smart Card is inserted into the WebTV/MSN TV receiver, it will show a message on the screen with the Smart Card name and a progress bar. In the background, it's contacting the URL from the <code>wtv-smartcard-inserted-url</code> header, which is usually <code>wtv-smartcard:/insert</code>. The box will POST the raw data read from the card to the URL (sometimes the box will base64 encode the data, but the reasoning for this is unknown), which will then decode it and return either a wtv-smartcard page with an error/confirmation page, or a redirect to somewhere else. In some cases, the box will send an error header (e.g: "error="-68") if something goes wrong.

== Structure ==
For now, we'll be focusing on Go To cards, as that's what we have info on.

This is the data stored on a Go To Smart Card:
<code>2Gÿt�Sony Value G�i999999</code>

We can break this data up into several parts to get all the data that the server decodes.

The first byte is the Smart Card generation, which appears to always be 2 except for a special type of Go To card, which uses generation 1. "Generation" is assumed to refer to the data format for the card.

The second byte is the Smart Card type, which is (G)o To in this case. Other observed values include (O)penISP and (A)ffinity.

ÿ appears to be a separator, which is followed by t�, which defines the start of the Smart Card title.

G�i appears to stand for "Go To ID", which is the ID for the Go To card. The ID has a corresponding URL that is stored on the server. If the ID is unknown, then a message about the Smart Card being expired or not yet active is sent to the client. The reasoning for this approach appears to be due to the size limit of Smart Cards (around 25 bytes) and so malicious cards can't be spread around.

So, to recap:

Card Generation: 2
Card Type: G
Card Title: Sony Value
Card ID: 999999