VirtTipsAndTricksMailVerificationService Using the Virtuoso Mail Verification Service Using the Virtuoso Mail Verification Service The Virtuoso Mail Verification Service verifies Email Addresses (also known as mailto:-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: Obtain an X.509 certificate with a WebID watermark . Verify your WebID-watermarked X.509 certificate . Install the ods_framework_dav.vad package which includes this functionality. Go to default endpoint for the service, http://<cname>/mv Enter your Email Address Check your inbox for a email message of the form: 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 Click on the Link in your mail and then identity yourself using WebID, if your identity is verified the process is complete View the descriptor document generated from this verification process via the URL pattern: http://<cname>/mv/data/{hash} Example: http://id.myopenlink.net/mv/data/494253e4df395054402e8ca04dbdcade26bc558b Service Endpoint Virtuoso Mail Verification Service endpoint is available at <http://cname/mv/>> . REST Interaction Patterns The service supports mbox parameter, which takes the Email Address to be verified as its value: URL pattern: http://<cname>/mv/mv.vsp?mbox={Email Address} Example: http://id.myopenlink.net/mv/mv.vsp?mbox=xx@domain.com 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 ods_framework_dav.vad package is installed. Steps Go to http://id.myopenlink.net/mv/ :
Enter your mail address:
Click "Verify". The following message should be shown: A confirmation mail was sent, please check your mail box.
Open your mail client associated with your mail box. A new message should arrive, respectively with: Subject Mail verification service Content Please click on the link below to confirm your email. https://id.myopenlink.net/mv/mc.vsp?confirm=fab83a65a15de7ccf4965e7fd004f4ba
Click on the link. You should be redirected to the Virtuoso Mail Verification Service, and be presented with a message that the email address has been confirmed:
View the descriptor document that results of this service by clicking the presented link:
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: Go to the Virtuoso X.509 certificate WebID-watermark Generator
In the presented form enter: "E-mail": e.g., demo@openlinksw.com "WebID (manual selection): http://id.myopenlink.net/dataspace/person/demo#this
Click "Lookup". Should be presented new "Mail verification URI" to be used, for example: http://id.myopenlink.net/mv/mv.vsp
Click the "Check" button Should be redirected to the Virtuoso Mail Verification Service with message for successfully sent message for confirmation:
Related OpenLink Data Spaces ODS-Webmail Virtuoso Generator for X.509 certificate with a WebID watermark Generating WebID-watermarked X.509 Certificates for Use with ODS WebID Protocol & SPARQL Endpoint ACLs Tutorial ODS OpenID support