How to Setup MagenQ

1. Make sure the card is inserted in your AirID and it is not connected to any other device
2. Start MagenQ
3. Press Connect to Reader button
4. Allow MagenQ to use Bluetooth
5. Select your AirID from the list
6. You will receive pairing request on your device and on your AirID. Confirm both of them in any order
7. Wait until the app connects to readed and fetches your certificate
8. Add necessary certificates to ios Keychain

Connection timeout - Allows you to configure how long reader stays connected to device with card being unused. During this time you do not need to enter PIN assuming you already entered correct PIN once.

Enable notifications - App will send notifications about starting connection to reader, successful connection to reader and disconnect from the reader if this option is enabled.

Advanced notifications - In addition to standard notifications app will also send additional ones when signing or decryption process is initiated. No recomended for everyday use since depending on the app there maybe a large amount of these notifications.

Reset keychain - Deletes all certificates added to device.

Share logs - Uploads logs to developers. Might be needed if bug is discovered. Please read Sharing feedback

Forget saved device - Once you pair with specific AirID MagenQ will connect only to this reader. If you need to change AirID for some reason (for instance yours became non-functional) use this option to forget saved AirID and then pair another one (refer to Getting Started for pairing instructions)

Before trying to use any app listed below make sure your AirID is on, within Bluetooth range and you have correct card inserted. Also note that when you try to use certificates from your card you wiil be asked to permit notifications. This permission is necessary to receive notifications about connection process to reader, successful connection to reader and disconnect from the reader. Permission is asked once and will not be asked ever again.

If you have VPN that requires certificate based authorization you can connect to it using MagenQ.

1. Open iOS Settings
2. Go to General - VPN & Device Management - VPN - Add VPN configuration
3. Fill out Type, Description, Server, Remote ID and Local ID fields
4. Change user authentication to Certificate
5. Select certificate from your card you want to authorize with
6. Save the profile
7. Try to enable VPN
8. Wait until connection to your AirID is established and PIN is asked
9. Enter correct PIN and press OK
10. If certificate you selected is suitable for this VPN and you should be successfully connected

1. Open Safari
2. Open the website which requires web authentication
3. You will see list of identity certificates available on your smart card. Select necessary certificate. Note: List will not appear if there is only one suitable certificate.
4. Wait until connection to your AirID is established and PIN is asked.
5. Enter correct PIN and press OK
6. If certificate you selected is suitable for this website you should successully login

1. Open Edge
2. Open the website which requires web authentication
3. App will ask your permission you access MagenQExt. Allow it.
4. You will see list of identity certificates available on your smart card. Select necessary certificate.
5. Wait until connection to your AirID is established and PIN is asked
6. Enter correct PIN and press OK
7. If certificate you selected is suitable for this website you should successully login.

This instruction assumes you have your mail account added to Apple Mail.

1. Open iOS Settings - Apps - Mail
2. Open Mail Accounts
3. Select your account
4. Open Account Settings - Advanced Settings. On the bottom you'll see S/MIME Sign and Encrypt by default options
5. If you want to sign your emails with digital signature open Sign menu, enable Sign and select a certificate for Digital Signature.
6. If you want to encrypt/decrypt messages open Encrypt by default menu. Select certificate for decryption. Enable Encrypt by default if you want. 

This instruction assumes you have your mail account added to Outlook

1. Open Outlook
2. Open Settings - Accounts - select your account - S/MIME
3. Enable S/MIME
4. App will ask your permission you access MagenQExt. Allow it.
5. Select your certificate for signing and encryption if you have more than one.
6. Optionally enable Signed and/or Encrypted in Always Send As section if you want your mail to be sent signed and/or encrypted by default

Follow this steps if you want to report a bug or send other feedback.

1. Open MagenQ
2. Open Settings -> Report a Problem
3. Explain what happened and, optionally, specify your email address (then we can follow-up with you to clarify details).
4. Send button.
5. The app will  sends logs securely to developers.