Getting Started Guide

Whether you want to replace your current authentication system with LaunchKey or use LaunchKey as an additional factor of authentication on top of an existing authentication system, you must have a few things in place in order to add password-less multi-factor authentication to your services and systems.

Install and Configure the Mobile Authenticator

Regardless what solution you will implement, you must install and configure the Mobile Authenticator. Refer to the Mobile App Guide for installation and configuration instructions as well as all of the features and options that are available to you and your users.

Create Your First Service

Create the Service

Create a new Service from the Dashboard New App Page . You will need to enter the following:

Service Name:The name of your new Service. This name should represent the Service it will secure as it will be displayed both to the User during the authorization process and in the Authorization list.
Description:Optional - A brief description of your new Service.
Avatar:Optional - An image for your new service. This avatar should also represent the service it will secure as it will be displayed both to the User with the service Name during the authentication process and in the Authorization list. Using an Avatar that fits with your service may give the user more confidence in the authorization process.
Terms of Service:Read the terms of service and check the box if you agree to them. You must do this for every service you create.

Once you have completed the form, click Create Service. The General tab on the Service page appears. The additional fields on this tab are required for different features that are explained elsewhere.

Note

This documentation refers to your new service as a Subscriber Service to clarify when the service is also used.

Set Up Your Keys

From the Service page of your new service, navigate to the Keys tab. The Keys tab has two sections, |product_name| API and Encryption Keys. The data in the |product_name| API section is not secret and therefore the values are visible. The data in the Encryption Keys section is secret and therefore not visible. The values of the secret fields can only be obtained when they are created.

To create a new Secret Key, click the New Secret Key button and select either Download new key or View & copy new key.

Next, create an RSA Public/Private Key Pair that will encrypt data when it is sent or returned, as well as sign data from your Service when communicating with the LaunchKey Platform. Create the RSA Public/Private Key Pair in one of two ways:

  • Recommended Generate your own RSA Public/Private Key Pair and upload the public key by clicking New Public Key and Upload new key.
  • Less Secure Have the Dashboard generate the RSA Public/Private Key Pair by first clicking New Private Key, and then choosing between Download new key to download the private key as a file, or View & copy new key to have the new private displayed on the page to be copied and saved.

Warning

Be sure to save the Secret Key and the private key for the RSA Public/Private Key Pair in a very secure location. These items are used by the LaunchKey Platform to protect your Service and its users from hackers that may try to impersonate your Service or decrypt data transmissions from the LaunchKey Platform to your Service.

User Contributed

LaunchKey links to user contributed code as a resource to its community. LaunchKey does not in any way guarantee or warrant the quality and security of these code bases. User contributed code is supported by the creators. If you do find a link from the site to user contributed code that is malicious or inappropriate in any way, please report that link to LaunchKey immediately and we will investigate the claim. Submit any issue to LaunchKey support at https://launchkey.com./support. ×