securitypolicy_rp.html

J2ME MIDP2.0 final specification

the PDA Profile to function groups</p>

<p class="Paragraph">Editor&#8217;s Note:  The current PIM API package does not
specify a write-only API. The necessary permissions to protect the
PIM API are not specified in the PIM package either. This table will
be updated once these changes are incorporated into the PIM API
package. 
</p>
<table border="1" cellpadding="0" cellspacing="3">
	<tbody><tr>
		<td colspan="3" width="99%">
			<p align="center" style="border: medium none ;">
			<b>PDAP PIM Package API (JSR75)</b></p>
		</td>
	</tr>
	<tr valign="top">
		<td width="32%">
			<p style="border: medium none ;">
			<b> Policy File Identifier</b></p>
		</td>
		<td width="41%">
			<p style="border: medium none ;">
			<b> Permitted Java API Calls</b></p>
		</td>
		<td width="25%">
			<p style="border: medium none ;">
			<b> Function group</b></p>
		</td>
	</tr>
	<tr valign="top">
		<td width="32%">
			<p style="border: medium none ;">
			 javax.microedition.pim.PIM.<br>contact.readonly</p>
		</td>
		<td width="41%">
			<p style="border: medium none ;">
			 PIM.listContactLists()<br>
			 PIM.openContactList(READ_ONLY)<br>
			 PIM.openContactList(READ_ONLY, listName)</p>
		</td>
		<td width="25%">
			<p style="border: medium none ;">
			 Read User Data Access</p>
		</td>
	</tr>
	<tr valign="top">
		<td width="32%">
			<p style="border: medium none ;">
			 javax.microedition.pim.PIM.<br>contact.readwrite</p>
		</td>
		<td width="41%">
			<p style="border: medium none ;">
			 PIM.listContactLists()<br>
			 PIM.openContactList(READ_ONLY)<br>
			 PIM.openContactList(READ_WRITE)<br>
			 PIM.openContactList(READ_ONLY, listName)<br>
			 PIM.openContactList(READ_WRITE, listName)</p>
		</td>
		<td width="25%">
			<p style="border: medium none ;">
			 Write User Data Access</p>
		</td>
	</tr>
	<tr valign="top">
		<td width="32%">
			<p style="border: medium none ;">
			 javax.microedition.pim.PIM.<br>event.readonly</p>
		</td>
		<td width="41%">
			<p style="border: medium none ;">
			 PIM.listEventLists()<br>
			 PIM.openEventList(READ_ONLY)<br>
			 PIM.openEventList(READ_ONLY, listName)</p>
		</td>
		<td width="25%">
			<p style="border: medium none ;">
			 Read User Data Access</p>
		</td>
	</tr>
	<tr valign="top">
		<td width="32%">
			<p style="border: medium none ;">
			 javax.microedition.pim.PIM.<br>event.readwrite</p>
		</td>
		<td width="41%">
			<p style="border: medium none ;">
			 PIM.listEventLists()<br>
			 PIM.openEventList(READ_ONLY)<br>
			 PIM.openEventList(READ_WRITE)<br>
			 PIM.openEventList(READ_ONLY, listName)<br>
			 PIM.openEventList(READ_WRITE, listName)</p>
		</td>
		<td width="25%">
			<p style="border: medium none ;">
			 Write User Data Access</p>
		</td>
	</tr>
	<tr valign="top">
		<td width="32%">
			<p style="border: medium none ;">
			 javax.microedition.pim.PIM.<br>todo.readonly</p>
		</td>
		<td width="41%">
			<p style="border: medium none ;">
			 PIM.listToDoLists()<br>
			 PIM.openToDoList(READ_ONLY)<br>
			 PIM.openToDoList(READ_ONLY, listName)</p>
		</td>
		<td width="25%">
			<p style="border: medium none ;"> Read
			User Data Access</p>
		</td>
	</tr>
	<tr valign="top">
		<td width="32%">
			<p style="border: medium none ;">
			 javax.microedition.pim.PIM.<br>todo.readwrite</p>
		</td>
		<td width="41%">
			<p style="border: medium none ;">
			 PIM.listToDoLists()<br>
			 PIM.openToDoList(READ_ONLY)<br>
			 PIM.openToDoList(READ_WRITE)<br>
			 PIM.openToDoList(READ_ONLY, listName)<br>
			 PIM.openToDoList(READ_WRITE, listName)</p>
		</td>
		<td width="25%">
			<p style="border: medium none ;">
			 Write User Data Access</p>
		</td>
	</tr>
</tbody></table>
<p class="Paragraph"> </p>
<p class="Paragraph">Implementation MUST ensure
that the user is informed of the nature of user data an application
has access to (for instance, events or to-do lists) before allowing
the application access to these functions. Whenever a MIDlet adds a
new PIM entry, the implementation MUST display it to the user for
acknowledgement.</p>
<p align="center">Table 4: Assigning proposed permissions and API calls
specified in the Bluetooth API to function groups</p>
<table border="1" cellpadding="0" cellspacing="3">
	<tbody><tr>
		<td colspan="3" width="99%">
			<p align="center" style="border: medium none ; padding: 0cm;">
			<b>Bluetooth API</b>&#8211;<b>
			JSR 82</b></p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;">
			<b> Policy File Identifiers (Proposed Permission)</b></p>
		</td>
		<td width="51%">
			<p style="border: medium none ; padding: 0cm;">
			<b> Permitted API calls</b></p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;">
			<b>Function group</b></p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.Connector.bluetooth.client</p>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;">
			  Connector.open(&#8220;btspp://&lt;server
			  BD_ADDR&gt;&#8230;&#8221;)<br>
			  Connector.open(&#8220;btl2cap://&lt;server
			  BD_ADDR&gt;&#8230;&#8221;)</p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Local
			Connectivity</p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;">
			  javax.microedition.io.Connector.obex.client</p>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;"> 
			  Connector.open(&#8220;btgoep://&lt;server
			  BD_ADDR&gt;&#8230;&#8221;)<br>
			  Connector.open(&#8220;irdaobex://discover&#8230;&#8221;)<br>
			  Connector.open(&#8220;irdaobex://addr&#8230;&#8221;)<br>
			  Connector.open(&#8220;irdaobex://conn&#8230;&#8221;)<br>
			  Connector.open(&#8220;irdaobex://name&#8230;&#8221;)</p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Local
			Connectivity</p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.Connector.obex.client.tcp</p>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;"> Connector.open(&#8220;tcpobex://&lt;server
			IP_ADDR&gt;&#8230;&#8221;)</p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Net
			Access</p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.Connector.bluetooth.server</p>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;">
			Connector.open(&#8220;btspp://localhost:&#8230;&#8221;)<br>
			Connector.open(&#8220;btl2cap://localhost:&#8230;&#8221;)</p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Local
			Connectivity</p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.Connector.obex.server</p>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;">
			Connector.open(&#8220;btgoep://localhost:&#8230;&#8221;)<br>
			Connector.open(&#8220;irdaobex://localhost:&#8230;&#8221;)</p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Local
			Connectivity</p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.Connector.obex.server.tcp</p>>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;">
			Connector.open(&#8220;tcpobex://:&lt;PORT&gt;&#8221;) <br>
			Connector.open(&#8220;tcpobex://&#8221;)</p> 
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Net
			Access</p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.PushRegistry.bluetooth.server</p>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;">
			  PushRegistry.registerConnection(&#8220;btspp://&lt;server
			  BD_ADDR&gt;:&lt;channel ID&gt;&#8221;)<br>
			  PushRegistry.registerConnection(&#8220;btl2cap://&lt;server
			  BD_ADDR&gt;:&lt;PSM&gt;&#8221;)</p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Application
			Auto Invocation</p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.PushRegistry.obex.server</p>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;"> PushRegistry.registerConnection(&#8220;btgoep://&lt;server
			BD_ADDR&gt;:&lt;channel ID&gt;&#8221;)</p>
			<p style="border: medium none ; padding: 0cm;"> PushRegistry.registerConnection(&#8220;irdaobex://???&#8230;&#8221;)</p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Application
			Auto Invocation</p>
		</td>
	</tr>
	<tr>
		<td width="34%">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.PushRegistry.obex.server.tcp</p>
		</td>
		<td width="51%" valign="top">
			<p style="border: medium none ; padding: 0cm;"> PushRegistry.registerConnection(&#8220;tcpobex://:&lt;PORT&gt;&#8221;)</p>
		</td>
		<td width="13%">
			<p style="border: medium none ; padding: 0cm;"> Application
			Auto Invocation</p>
		</td>
	</tr>
</tbody></table>
<p class="Paragraph">Note: The permissions proposed for Bluetooth API are yet to be
defined in JSR82.</p>
<p align="center">Table 5: Assigning proposed permissions and API calls
specified in the Wireless Messaging API to function groups</p>
<table border="1" cellpadding="0" cellspacing="3">
	<tbody><tr>
		<td colspan="3" width="98%">
			<p align="center" style="border: medium none ; padding: 0cm;">
			<b>Wireless Messaging API </b>&#8211;<b>
			JSR 120</b></p>
		</td>
		
	</tr>
	<tr>
		<td width="30%">
			<p style="border: medium none ; padding: 0cm;">
			<b> Policy File Identifier (Proposed Permission)</b></p>
		</td>
		<td width="49%">
			<p style="border: medium none ; padding: 0cm;"> 
			  <b>Permitted API calls</b></p>
		</td>
		<td colspan="1" width="19%">
			<p style="border: medium none ; padding: 0cm;">
			<b> Function group</b></p>
		</td>
	</tr>
	<tr>
		<td width="30%" valign="top">
			<p style="border: medium none ; padding: 0cm;"> javax.microedition.io.Connector.sms.send</p>
		</td>
		<td width="49%" valign="top">
			<p style="border: medium none ; padding: 0cm;">
			  Connector.open("sms://&#8230;", WRITE)<br>
			  Connector.open("sms://&#8230;", WRITE, Bool)</p>
		</td>
		<td colspan="1" width="19%">
			<p style="border: medium none ; padding: 0cm;">
			 Messaging</p>
		</td>
	</tr>
	<tr>
		<td width="30%" valign="top">
			<p style="border: medium none ; padding: 0cm;">
			  javax.microedition.io.Connector.sms.receive</p>
		</td>
		<td width="49%" valign="top">
			<p style="border: medium none ; padding: 0cm;"> 
			  Connector.open("sms://&#8230;", READ)<br>
			  Connector.open("sms://&#8230;", READ, Bool)</p>
		</td>
		<td colspan="1" width="19%">