%META:TOPICPARENT{name="VirtTipsAndTricksGuide"}%

---+ Using the Virtuoso Mail Verification Service

%TOC%

The Virtuoso Mail Verification Service verifies Email Addresses (also known as <code>mailto:</code>-scheme URIs) against WebIDs (which may use various URI schemes). 

---++Why is it Important?

Email Addresses are one of the most universally used, and intuitively understood, personal identifiers in use across both the World Wide Web and the Internet. 

Making these Addresses verifiable fills a critical gap in the puzzle of Internet- and Web-scale verifiable identity. 

---++How Do I Use It?

Perform the following steps:

   1 [[http://id.myopenlink.net/certgen/][Obtain an X.509 certificate with a WebID watermark]] .
   1 [[http://id.myopenlink.net/ods/webid_demo.html][Verify your WebID-watermarked X.509 certificate]] .
   1 Install the [[https://virtuoso.openlinksw.com/download/][ods_framework_dav.vad]] package which includes this functionality.
   1 Go to default endpoint for the service, http://&lt;cname&gt;/mv 
   1 Enter your Email Address
   1 Check your inbox for a email message of the form:
<verbatim>
Please click on the link below to confirm your email.
https://<cname>/mv/mc.vsp?confirm={hash}

Example: 
https://id.myopenlink.net/mv/mc.vsp?confirm=b29e6a2dcd201d1e98321c474f80c7a1
</verbatim>
   1 Click on the Link in your mail and then identity yourself using WebID, if your identity is verified the process is complete
   1 View the descriptor document generated from this verification process via the URL pattern: 
<verbatim>
http://<cname>/mv/data/{hash}

Example: http://id.myopenlink.net/mv/data/494253e4df395054402e8ca04dbdcade26bc558b
</verbatim>



---+++Service Endpoint


Virtuoso Mail Verification Service endpoint is available at <code>&lt;http://cname/mv/&gt;</code> .

---+++REST Interaction Patterns

The service supports <code>mbox</code> parameter, which takes the Email Address to be verified as its value:

<verbatim>
URL pattern: http://<cname>/mv/mv.vsp?mbox={Email Address}

Example: http://id.myopenlink.net/mv/mv.vsp?mbox=xx@domain.com
</verbatim>


---++++Usage Scenario 1 

In this case, we look at the simple Email Address verification via an HTML page associated with the service.  

---+++++ Prerequisites

Make sure the [[https://virtuoso.openlinksw.com/download/][ods_framework_dav.vad]] package is installed.

---+++++Steps

   1 Go to http://id.myopenlink.net/mv/ :
%BR%%BR%<img src="%ATTACHURLPATH%/vf1.png" />%BR%%BR%
   1 Enter your mail address:
%BR%%BR%<img src="%ATTACHURLPATH%/vf2.png" />%BR%%BR%
   1 Click "Verify".
   1 The following message should be shown:
<verbatim>
A confirmation mail was sent, please check your mail box.
</verbatim>
%BR%%BR%<img src="%ATTACHURLPATH%/vf3.png" />%BR%%BR%
   1 Open your mail client associated with your mail box. 
   1 A new message should arrive, respectively with:
      * *Subject*
<verbatim>
Mail verification service
</verbatim>
      * *Content*
<verbatim>
Please click on the link below to confirm your email.
https://id.myopenlink.net/mv/mc.vsp?confirm=fab83a65a15de7ccf4965e7fd004f4ba
</verbatim>
%BR%%BR%<img src="%ATTACHURLPATH%/vf4.png" />%BR%%BR%
   1 Click on the link.
   1 You should be redirected to the Virtuoso Mail Verification Service, and be presented with a message that the email address has been confirmed:
%BR%%BR%<img src="%ATTACHURLPATH%/vf5.png" />%BR%%BR%
   1 View the descriptor document that results of this service by clicking the presented link:
%BR%%BR%<img src="%ATTACHURLPATH%/vf6.png" />%BR%%BR%


---++++Usage Scenario 2

This example demonstrates integration with the Virtuoso X.509 Certificate Generator whereby the Mail Verification service ensures that only verified Email Addresses are added to the claims in a WebID watermarked X.509 Certificate:

   1 Go to the [[http://id.myopenlink.net/certgen/][Virtuoso X.509 certificate WebID-watermark Generator]]
%BR%%BR%<img src="%ATTACHURLPATH%/cr1.png" />%BR%%BR%
   1 In the presented form enter:
      * "E-mail": e.g., demo@openlinksw.com
      * "WebID (manual selection): http://id.myopenlink.net/dataspace/person/demo#this
%BR%%BR%<img src="%ATTACHURLPATH%/cr2.png" />%BR%%BR%
   1 Click "Lookup".
   1 Should be presented new "Mail verification URI" to be used, for example:
<verbatim>
http://id.myopenlink.net/mv/mv.vsp
</verbatim>
%BR%%BR%<img src="%ATTACHURLPATH%/cr3.png" />%BR%%BR%
   1 Click the "Check" button
   1 Should be redirected to the Virtuoso Mail Verification Service with message for successfully sent message for confirmation:
%BR%%BR%<img src="%ATTACHURLPATH%/cr4.png" />%BR%%BR%

---++Related

   * [[http://ods.openlinksw.com/wiki/ODS/][OpenLink Data Spaces]]
   * [[http://ods.openlinksw.com/wiki/ODS/OdsMail][ODS-Webmail]]
   * [[http://id.myopenlink.net/certgen/][Virtuoso Generator for X.509 certificate with a WebID watermark]]
   * [[http://ods.openlinksw.com/wiki/ODS/ODSGenerateX509Certificate][Generating WebID-watermarked X.509 Certificates for Use with ODS]]
   * [[VirtSPARQLSecurityWebID][WebID Protocol & SPARQL Endpoint ACLs Tutorial]]
   * [[http://ods.openlinksw.com/dataspace/dav/wiki/ODS/ODSOpenID][ODS OpenID support]]