UniToken Integration Outlook Express: Difference between revisions

From SecuTech Wiki
Jump to navigationJump to search
Bao (talk | contribs)
mNo edit summary
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[category:UniToken_Integration_Guide]]
[[category:UniToken_Integration_Guide]]


== Install the PKI package ==
== Install the PKI package ==


This part explains how to install the PKI package that you can find inside the SDK. The End User package can be found inside the folder Redist/Enduser.  
This section explains how to install the PKI package that can be found inside the UniToken SDK. The End User package can be found inside the folder "Redist/Enduser/".  


{| cellspacing="0" cellpadding="0" border="0" width=""
{| class="wikitable"
|-
|-
| width="50" |  '''1'''  
| width="50" | '''1'''  
| width="400" | Right-Click on the PKI package installation file and choose “Run as administrator”<br>Execute the file with an account that has administrator rights on this computer.<br><br>
| width="400" | Right-click on the PKI package installation file and choose [Run as administrator].Execute the file with an account that has administrator rights on this computer.
| [[Image:Bitlocker img01.jpg|370x259px]]<br><br>
| [[Image:Bitlocker img01.jpg|370x259px]]
|-
|-
| width="50" | &nbsp;'''2'''  
| width="50" | '''2'''  
| width="400" | Click on [Next] in the welcome screen.<br>
| width="400" | Click on [Next] in the InstallShield Wizard welcome screen.
| [[Image:Bitlocker img02.jpg|370px]]<br><br>
| [[Image:Bitlocker img02.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''3'''  
| width="50" | '''3'''  
| width="400" | Input your username and Company Name and click on [Next].<br>
| width="400" | Input your User Name and Company Name and click on [Next].
| [[Image:Bitlocker img03.jpg|370px]]<br><br>
| [[Image:Bitlocker img03.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''4'''  
| width="50" | '''4'''  
| width="400" | Select [Complete] and click on [Next].<br>
| width="400" | Select [Complete] and click on [Next].
| [[Image:Bitlocker img04.jpg|370px]]<br><br>
| [[Image:Bitlocker img04.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''5'''  
| width="50" | '''5'''  
| width="400" | Click on [Install] to begin the installation of the PKI package.<br>
| width="400" | Click on [Install] to begin the installation of the PKI package.
| [[Image:Bitlocker img05.jpg|370px]]<br><br>
| [[Image:Bitlocker img05.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''6'''  
| width="50" | '''6'''  
| width="400" | Verify that the install wizard completed correctly and click on [Finish].<br>
| width="400" | Verify that the InstallShield Wizard completed successfully and click on [Finish].
| [[Image:Bitlocker img06.jpg|370px]]<br><br>
| [[Image:Bitlocker img06.jpg|370px]]
|}
|}
<br>


== Request a VeriSign Certificate ==
== Request a VeriSign Certificate ==


{| cellspacing="0" cellpadding="0" border="0" width=""
{| class="wikitable"
|-
|-
| width="50" | &nbsp;'''1'''  
| width="50" | '''1'''  
| width="400" | Open Internet Explorer and go to the page  
| width="400" | Open your internet browser of your choice and navigate to the page https://digitalid.verisign.com/client/class1MS.htm With VeriSign, you have the option of either buying a digital certificate, or obtaining a free evaluation digital certificate usable for 60 days.
https://digitalid.verisign.com/client/class1MS.htm<br><br>
| [[Image:adobepdf img01.jpg|370px]]
You can buy a digital certificate or can a free evaluation version that is fully usable for 60days.<br>
| [[Image:adobepdf img01.jpg|370px]]<br><br>
|-
|-
| width="50" | &nbsp;'''2'''  
| width="50" | '''2'''  
| width="400" | In the field “Cryptographic Service Provider Name”, choose “UniToken PRO CSP v2.0”.<br>
| width="400" | In the field "Cryptographic Service Provider Name", choose [UniToken PRO CSP v2.0].
 
| [[Image:adobepdf img02.jpg|370px]]
| [[Image:adobepdf img02.jpg|370px]]<br><br>
|-
|-
| width="50" | &nbsp;'''3'''  
| width="50" | '''3'''  
| width="400" | Click on [Accept] to request the certificate. <br>
| width="400" | Click on [Accept] to request the certificate.
| [[Image:adobepdf img03.jpg|370px]]<br><br>
| [[Image:adobepdf img03.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''4'''  
| width="50" | '''4'''  
| width="400" | Type the correct user PIN for UniToken PRO and click on [OK].<br>
| width="400" | Type the corresponding User PIN for the UniToken PRO device and click [OK].
| [[Image:adobepdf img04.jpg|370px]]<br><br>
| [[Image:adobepdf img04.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''5'''  
| width="50" | '''5'''  
| width="400" | Check the mailbox that you used to request the certificate. You should have receive a mail explaining how to continue the request procedure.<br>
| width="400" | An email containing a Digital ID PIN and explaining how to continue the request procedure will be sent to the email address specified earlier. Copy the Digital ID PIN from the email and navigate to the URL specified in the email, https://digitalid.verisign.com/enrollment/mspickup.htm .
Copy the Digital ID PIN and go to the URL written in the mail.( https://digitalid.verisign.com/enrollment/mspickup.htm).<br>
| [[Image:adobepdf img05.jpg|370px]]
| [[Image:adobepdf img05.jpg|370px]]<br><br>
|-
|-
| width="50" | &nbsp;'''6'''  
| width="50" | '''6'''  
| width="400" | Paste the Digital ID PIN that you copied from the mail
| width="400" | Paste the Digital ID PIN copied from the email in the corresponding field and click on [Submit].
in the corresponding field and click on [Submit].<br>
| [[Image:adobepdf img06.jpg|370px]]
| [[Image:adobepdf img06.jpg|370px]]<br><br>
|-
|-
| width="50" | &nbsp;'''7'''  
| width="50" | '''7'''  
| width="400" | Click on [INSTALL] to import the certificate inside your UniToken PRO. If you have UniToken Monitor running, you should get a “certificate imported successfully” message.<br>
| width="400" | Click on [INSTALL] to import the certificate inside your UniToken PRO. If UniToken Monitor is running, a "Certificate Imported Successfully" message will appear. The request procedure is complete. You can now use this certificate to protect documents, sign and encrypt emails and related applications.
The request procedure is complete. You can now use this certificate to protect documents, sign and encrypt mails.<br>
| [[Image:adobepdf img07.jpg|370px]]
| [[Image:adobepdf img07.jpg|370px]]<br><br>
|}
|}


== Sign and encrypt mail ==
== Sign and Encrypt Emails ==


In the case you asked for an evaluation certificate from VeriSign, you must trust it in the Internet Explorer Options first to be able to see it in Outlook Express.(please find in the SDK the certificate that you must install for it).<br>
In the case an evaluation certificate from VeriSign was used, you must add it to the list of trusted certificates in it in Outlook Express (and other associated programs, if necessary). Please find in the [[#Attachments|attachments]] the certificates to install. '''Certificates to install:'''
'''Certificates to install:'''
* VeriSign Class 1 Individual Subscriber CA - G3.cer  
*VeriSign Class 1 Individual Subscriber CA - G3.cer  
* VeriSign Class 1 Public Primary Certification Authority - G3.cer  
*VeriSign Class 1 Public Primary Certification Authority - G3.cer  
<br><br>


{| cellspacing="0" cellpadding="0" border="0" width=""
{| class="wikitable"
|-
|-
| width="50" | &nbsp;'''1'''  
| width="50" | '''1'''  
| width="400" | '''User 1 mailbox (receiver.secutech)'''<br><br>In Microsoft Outlook 2003,  below  the main menu, select [New] to create a new message. <br>
| width="400" | '''User 1's Mailbox (receiver.secutech)'''In Microsoft Outlook 2003, select [New] to compose a new email.  
| [[Image:outlookexpress img01.jpg|370px]]<br><br>
| [[Image:outlookexpress img01.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''2'''  
| width="50" | '''2'''  
| width="400" | Below the main menu, in the tool bar click on [Options].<br>
| width="400" | Below the main menu in the tool bar, click [Options].
| [[Image:mail2003 img02.jpg|370px]]<br><br>
| [[Image:outlookexpress img02.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''3'''  
| width="50" | '''3'''  
| width="400" | On the [Message Options] page, click on  [Security  
| width="400" | On the [Message Options] page, click [Security Settings].
Settings]<br>
| [[Image:outlookexpress img03.jpg|370px]]
| [[Image:outlookexpress img03.jpg|370px]]<br><br>
|-
|-
| width="50" | &nbsp;'''4'''  
| width="50" | '''4'''  
| width="400" | On the [Security Properties] page, check [Add digital  
| width="400" | On the [Security Properties] page, check [Add digital  
signature to this message] and click on [Change Settings] <br>
signature to this message] and click on [Change Settings].
| [[Image:outlookexpress img04.jpg|370px]]<br><br>
| [[Image:outlookexpress img04.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''5'''  
| width="50" | '''5'''  
| width="400" | Click on [Choose] to Select the certificate stored inside  
| width="400" | Click on [Choose] to select the certificate stored inside  
the UniToken and click on [OK] consecutively until you get back to [New Message] window.<br>
the UniToken and click on [OK] consecutively until you get back to [New Message] window.
| [[Image:outlookexpress img05.jpg|370px]]<br><br>
| [[Image:outlookexpress img05.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''6'''  
| width="50" | '''6'''  
| width="400" | In the new mail window, click on [Send] to send the  
| width="400" | In the new mail window, click on [Send] to send the  
signed mail. You will be asked for the UniToken password.<br>
signed mail. You will be asked for the UniToken password.
| [[Image:outlookexpress img06.jpg|370px]]<br><br>
| [[Image:outlookexpress img06.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''7'''  
| width="50" | '''7'''  
| width="400" | '''User 2 mailbox (helper.secutech)''' <br><br>Go the mail account that you’ve just sent the signed mail to, and click on [Send/Recv]. Open the signed mail, right-click on the sender name and choose [Add to Outlook Contacts]<br>
| width="400" | '''User 2's Mailbox (helper.secutech)''' Go the mail account that you’ve just sent the signed mail to, and click on [Send/Recv]. Open the signed mail, right-click on the sender name and choose [Add to Outlook Contacts]
| [[Image:outlookexpress img07.jpg|370px]]<br><br>
| [[Image:outlookexpress img07.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''8'''  
| width="50" | '''8'''  
| width="400" | Click on [Save and Close] to save the information about User 1 (receiver.secutech) as well as his certificate. <br>
| width="400" | Click on [Save and Close] to save the information about User 1 (receiver.secutech) as well as his certificate.  
| [[Image:outlookexpress img08.jpg|370px]]<br><br>
| [[Image:outlookexpress img08.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''9'''  
| width="50" | '''9'''  
| width="400" | Back to the main window of Microsoft 2003, select the  
| width="400" | Back to the main window of Microsoft 2003, select the signed email and click on [Reply]. Now that you have received that user’s digital signature, you can send encrypted mails to that user (The public key of that user is included in the signature)
signed email and click on [Reply].<br><br>
| [[Image:outlookexpress img09.jpg|370px]]
Now that you have received that user’s digital signature, you can send encrypted mails to that user (The public key of that user is included in the  
signature)<br>
| [[Image:outlookexpress img09.jpg|370px]]<br><br>
|-
|-
| width="50" | &nbsp;'''10'''  
| width="50" | '''10'''  
| width="400" | Click on the [ ] icon on the top right of the windows  
| width="400" | Click on the [ ] icon on the top right of the windows and click on [Send] to send the encrypted message. If the signature and encryption icon doesn’t appear, you can configure message encryption from [Options…] [Security settings] [Encrypt message and attachment]
and click on [Send] to send the encrypted message. <br><br>
| [[Image:outlookexpress img10.jpg|370px]]
If the signature and encryption icon doesn’t appear, you can configure message encryption from [Options…] [Security settings] [Encrypt message and attachment]<br>
| [[Image:outlookexpress img10.jpg|370px]]<br><br>
|}
|}


== Open an encrypted mail ==
== Open an encrypted mail ==


{| cellspacing="0" cellpadding="0" border="0" width=""
{| class="wikitable"
|-
|-
| width="50" | &nbsp;'''1'''  
| width="50" | '''1'''  
| width="400" | User 1 mailbox (receiver.secutech)<br><br>Go back to User 1’s mailbox and check your mail. You should have received the encrypted mail from User 2. Double-click on it to open it.<br>
| width="400" | '''User 1 mailbox (receiver.secutech)''' Go back to User 1’s mailbox and check your mail. You should have received the encrypted mail from User 2. Double-click on it to open it.
| <center>[[Image:mail2003 img11.jpg|370px]]</center><br><br>
| <center>[[Image:outlookexpress img17.jpg|370px]]</center>
|-
|-
| width="50" | &nbsp;'''2'''  
| width="50" | '''2'''  
| width="400" | If your UniToken is inserted, you will be able to see the  
| width="400" | A warning security will display “This message has been encrypted by the sender”. Click on [Continue] to see the mail.
content of the mail.<br><br>
| [[Image:outlookexpress img18.jpg|370px]]
''Note: If you’ve just inserted UniToken,  you will be asked for the user password to decrypt the mail. Otherwise, there is no need to input the password once again''<br>
 
| [[Image:mail2003 img12.jpg|370px]]<br><br>
|-
|-
| width="50" | &nbsp;'''3'''  
| width="50" | '''3'''  
| width="400" | If UniToken is not inserted or if the certificate is incorrect, the message [Cannot Open this item. Your digital ID name cannot  be found by the underlying system]<br>
| width="400" | If your UniToken is inserted, you will be able to see the content of the mail. Note: If you’ve just inserted UniToken, you will be asked for the user password to decrypt the mail. Otherwise, there is no need to input the password once again.
| [[Image:mail2003 img13.jpg|370px]]<br><br>
| [[Image:outlookexpress img19.jpg|370px]]
|-
|-
| width="50" | &nbsp;'''4'''  
| width="50" | '''4'''  
| width="400" | If UniToken is not inserted  or if the certificate is incorrect, the message [Cannot Open this item. Your digital ID name cannot  be found by the underlying system]<br>
| width="400" | If you remove the UniToken and try to open the encrypted mail, you will get the error “Error Decrypting Message”
| [[Image:mail2003 img13.jpg|370px]]<br><br>
| [[Image:outlookexpress img20.jpg|370px]]
|}
|}


== Glossary ==
== Glossary ==


'''Digital Signature''': is a mathematical scheme for demonstrating the authenticity of a digital message or document. A valid digital signature gives a recipient reason to believe that the message was created by a known sender, and that it was not altered in transit.
'''Digital Signature''': a mathematical scheme for demonstrating the authenticity of a digital message or document. A valid digital signature gives a recipient reason to believe that the message was created by a known sender, and that it was not altered in transit.
 
'''Public Key Infrastructure (PKI)''': a set of hardware, software, people, policies, and procedures needed to create, manage, distribute, use, store, and revoke digital certificates.
 
'''Microsoft Cryptography API, MS-CAPI''': an application programming interface included with Microsoft Windows operating systems that provides services to enable developers to secure Windows-based applications using cryptography.


'''Public Key Infrastructure (PKI)''' is a set of hardware, software, people, policies, and procedures needed to create, manage, distribute, use, store, and revoke digital certificates.
'''PKCS''': refers to a group of public-key cryptography standards devised and published by RSA Security.


'''Microsoft Cryptography API, MS-CAPI''' is an application programming interface included with Microsoft Windows operating systems that provides services to enable developers to secure Windows-based applications using cryptography.
== Attachments ==


'''PKCS''' refers to a group of public-key cryptography standards devised and published by RSA Security.
* [[File:Certificates for Outlook Express Mail.zip]]

Latest revision as of 17:02, 23 August 2016


Install the PKI package

This section explains how to install the PKI package that can be found inside the UniToken SDK. The End User package can be found inside the folder "Redist/Enduser/".

1 Right-click on the PKI package installation file and choose [Run as administrator].Execute the file with an account that has administrator rights on this computer.
2 Click on [Next] in the InstallShield Wizard welcome screen.
3 Input your User Name and Company Name and click on [Next].
4 Select [Complete] and click on [Next].
5 Click on [Install] to begin the installation of the PKI package.
6 Verify that the InstallShield Wizard completed successfully and click on [Finish].

Request a VeriSign Certificate

1 Open your internet browser of your choice and navigate to the page https://digitalid.verisign.com/client/class1MS.htm With VeriSign, you have the option of either buying a digital certificate, or obtaining a free evaluation digital certificate usable for 60 days.
2 In the field "Cryptographic Service Provider Name", choose [UniToken PRO CSP v2.0].
3 Click on [Accept] to request the certificate.
4 Type the corresponding User PIN for the UniToken PRO device and click [OK].
5 An email containing a Digital ID PIN and explaining how to continue the request procedure will be sent to the email address specified earlier. Copy the Digital ID PIN from the email and navigate to the URL specified in the email, https://digitalid.verisign.com/enrollment/mspickup.htm .
6 Paste the Digital ID PIN copied from the email in the corresponding field and click on [Submit].
7 Click on [INSTALL] to import the certificate inside your UniToken PRO. If UniToken Monitor is running, a "Certificate Imported Successfully" message will appear. The request procedure is complete. You can now use this certificate to protect documents, sign and encrypt emails and related applications.

Sign and Encrypt Emails

In the case an evaluation certificate from VeriSign was used, you must add it to the list of trusted certificates in it in Outlook Express (and other associated programs, if necessary). Please find in the attachments the certificates to install. Certificates to install:

  • VeriSign Class 1 Individual Subscriber CA - G3.cer
  • VeriSign Class 1 Public Primary Certification Authority - G3.cer
1 User 1's Mailbox (receiver.secutech)In Microsoft Outlook 2003, select [New] to compose a new email.
2 Below the main menu in the tool bar, click [Options].
3 On the [Message Options] page, click [Security Settings].
4 On the [Security Properties] page, check [Add digital

signature to this message] and click on [Change Settings].

5 Click on [Choose] to select the certificate stored inside

the UniToken and click on [OK] consecutively until you get back to [New Message] window.

6 In the new mail window, click on [Send] to send the

signed mail. You will be asked for the UniToken password.

7 User 2's Mailbox (helper.secutech) Go the mail account that you’ve just sent the signed mail to, and click on [Send/Recv]. Open the signed mail, right-click on the sender name and choose [Add to Outlook Contacts]
8 Click on [Save and Close] to save the information about User 1 (receiver.secutech) as well as his certificate.
9 Back to the main window of Microsoft 2003, select the signed email and click on [Reply]. Now that you have received that user’s digital signature, you can send encrypted mails to that user (The public key of that user is included in the signature)
10 Click on the [ ] icon on the top right of the windows and click on [Send] to send the encrypted message. If the signature and encryption icon doesn’t appear, you can configure message encryption from [Options…] [Security settings] [Encrypt message and attachment]

Open an encrypted mail

1 User 1 mailbox (receiver.secutech) Go back to User 1’s mailbox and check your mail. You should have received the encrypted mail from User 2. Double-click on it to open it.
2 A warning security will display “This message has been encrypted by the sender”. Click on [Continue] to see the mail.
3 If your UniToken is inserted, you will be able to see the content of the mail. Note: If you’ve just inserted UniToken, you will be asked for the user password to decrypt the mail. Otherwise, there is no need to input the password once again.
4 If you remove the UniToken and try to open the encrypted mail, you will get the error “Error Decrypting Message”

Glossary

Digital Signature: a mathematical scheme for demonstrating the authenticity of a digital message or document. A valid digital signature gives a recipient reason to believe that the message was created by a known sender, and that it was not altered in transit.

Public Key Infrastructure (PKI): a set of hardware, software, people, policies, and procedures needed to create, manage, distribute, use, store, and revoke digital certificates.

Microsoft Cryptography API, MS-CAPI: an application programming interface included with Microsoft Windows operating systems that provides services to enable developers to secure Windows-based applications using cryptography.

PKCS: refers to a group of public-key cryptography standards devised and published by RSA Security.

Attachments