|   |   | 
| Line 307: | Line 307: | 
|  | | ''Out:''   |  | | ''Out:''   | 
|  | | (5a, 5b, 5c) http request for suggested email addresses. |  | | (5a, 5b, 5c) http request for suggested email addresses. | 
|  | | suggested email addresses and prices in JSON. 
 |  | 
|  | | 
 |  | 
|  | |}
 |  | 
|  | 
 |  | 
|  | === Mozilla Messaging server  ===
 |  | 
|  | 
 |  | 
|  | This component sends the configuration data to the addon, and gets and collates the list of suggested email addresses from the third party providers. 
 |  | 
|  | 
 |  | 
|  | It interacts with the addon to send it the configuration at startup, and to get the first and last name to get the list of suggestions. 
 |  | 
|  | 
 |  | 
|  | It interacts with the selected third party email providers to get the list of suggestions to return to the addon. 
 |  | 
|  | 
 |  | 
|  | The tables below simply summarize the data encountered by this component. 
 |  | 
|  | 
 |  | 
|  | '''Stored Data:''' 
 |  | 
|  | 
 |  | 
|  | {| class="wikitable"
 |  | 
|  | |-
 |  | 
|  | ! what 
 |  | 
|  | | where 
 |  | 
|  | | notes
 |  | 
|  | |-
 |  | 
|  | | client ip. 
 |  | 
|  | | http logs. 
 |  | 
|  | | this is inadvertent, and should be purged (or collected into stats, and then purged) on a regular basis.
 |  | 
|  | |}
 |  | 
|  | 
 |  | 
|  | '''Communication with addon''' 
 |  | 
|  | 
 |  | 
|  | {| class="wikitable"
 |  | 
|  | |-
 |  | 
|  | ! Direction 
 |  | 
|  | ! Message 
 |  | 
|  | ! Data 
 |  | 
|  | ! Notes
 |  | 
|  | |-
 |  | 
|  | | ''In:'' 
 |  | 
|  | | http request for /provider/list (1)
 |  | 
|  | | None. 
 |  | 
|  | | 
 |  | 
|  | |-
 |  | 
|  | | 
 |  | 
|  | | http request for /suggest (3)
 |  | 
|  | | First name, last name, client IP. 
 |  | 
|  | | 
 |  | 
|  | |-
 |  | 
|  | | ''Out:'' 
 |  | 
|  | | http response for /provider/list (2)
 |  | 
|  | | static configuration info, in JSON. 
 |  | 
|  | | See [http://bwinton.latte.ca/Work/provider/list]
 |  | 
|  | |-
 |  | 
|  | | 
 |  | 
|  | | http response for /suggest (6)
 |  | 
|  | | static configuration info, in JSON. 
 |  | 
|  | | See [http://bwinton.latte.ca/Work/provider/suggestFromName.cgi?first_name=Blake&last_name=Winton]
 |  | 
|  | |}
 |  | 
|  | 
 |  | 
|  | '''Communication with third party email provider''' 
 |  | 
|  | 
 |  | 
|  | {| class="wikitable"
 |  | 
|  | |-
 |  | 
|  | ! Direction 
 |  | 
|  | ! Message 
 |  | 
|  | ! Data 
 |  | 
|  | ! Notes
 |  | 
|  | |-
 |  | 
|  | | ''In:'' 
 |  | 
|  | | http response for suggested email addresses. (5a, 5b, 5c)
 |  | 
|  | | suggested email addresses and prices in JSON. 
 |  | 
|  | | 
 |  | 
|  | |-
 |  | 
|  | | ''Out:'' 
 |  | 
|  | | http request for suggested email addresses. (4a, 4b, 4c)
 |  | 
|  | | First name, last name. 
 |  | 
|  | | Not client IP address.
 |  | 
|  | |}
 |  | 
|  | 
 |  | 
|  | 
 |  | 
|  | === Third party email providers  ===
 |  | 
|  | 
 |  | 
|  | This component returns the list of suggested email addresses, and creates the account. 
 |  | 
|  | 
 |  | 
|  | It interacts with the addon through a browser tab to allow the user to sign up, and to return the data to create the account. 
 |  | 
|  | 
 |  | 
|  | It interacts with the Mozilla Messaging server to return the list of suggested email addresses. 
 |  | 
|  | 
 |  | 
|  | Note: We don't write this component, and have limited influence over what it does. 
 |  | 
|  | 
 |  | 
|  | The tables below simply summarize the data encountered by this component. 
 |  | 
|  | 
 |  | 
|  | '''Stored Data:''' 
 |  | 
|  | 
 |  | 
|  | {| class="wikitable"
 |  | 
|  | |-
 |  | 
|  | ! what 
 |  | 
|  | | notes
 |  | 
|  | |-
 |  | 
|  | | Unknown. 
 |  | 
|  | | Since this is the third-party server, we should assume they store everything they can.
 |  | 
|  | |}
 |  | 
|  | 
 |  | 
|  | '''Communication with the addon''' 
 |  | 
|  | 
 |  | 
|  | {| class="wikitable"
 |  | 
|  | |-
 |  | 
|  | ! Direction 
 |  | 
|  | ! Message 
 |  | 
|  | ! Data 
 |  | 
|  | ! Notes
 |  | 
|  | |-
 |  | 
|  | | ''In:'' 
 |  | 
|  | | http request for first sign-up page.  (8a, 8c)
 |  | 
|  | | First name, last name, selected email address, client IP. 
 |  | 
|  | | 
 |  | 
|  | |-
 |  | 
|  | | ''Out:'' 
 |  | 
|  | | sign-up page(s) (8b, 8d)
 |  | 
|  | | html 
 |  | 
|  | | There may be more than one page in the sign-up process.
 |  | 
|  | |}
 |  | 
|  | 
 |  | 
|  | '''Communication with Mozilla Messaging server''' 
 |  | 
|  | 
 |  | 
|  | {| class="wikitable"
 |  | 
|  | |-
 |  | 
|  | ! Direction 
 |  | 
|  | ! Message 
 |  | 
|  | ! Data 
 |  | 
|  | ! Notes
 |  | 
|  | |-
 |  | 
|  | | ''In:'' 
 |  | 
|  | | http request for suggested email addresses. (4a, 4b, 4c)
 |  | 
|  | | First name, last name. 
 |  | 
|  | | Not client IP address.
 |  | 
|  | |-
 |  | 
|  | | ''Out:'' 
 |  | 
|  | | http request for suggested email addresses. (5a, 5b, 5c)
 |  | 
|  | | suggested email addresses and prices in JSON.   |  | | suggested email addresses and prices in JSON.   | 
|  | |   |  | |   |