PeopleVine

Authenticating a Customer to Access your Application (that is connected to the PeopleVine API)

So you've built your app, but now you need to authenticate your customers before they can login to your app.  You can do this by simply routing your users to the out of the box login screen (branded with your company and design).

Simply send your customers to http://yourdomain.com/login.aspx with the following parameters:

  • track - this should be a random string that is sent back to you upon successful authentication in an effort to ensure they have routed through the PeopleVine authentication first
  • reroute - this is the URL you would like us to route the user back to.  We will also append the track parameter and a newly generated user_username and user_password which is only able to access your application.  Make sure you url encode the reroute value
  • api_key - this is the API key of your application and is tied to the users credentials
  • subscription=active (optional) - this will validate to see if they have an active subscription, if not they will be routed to re-activate their subscription

An example of the URL would be:

http://yourdomain.com/login.aspx?track=AKJgKoigj428aejfka&reroute=http%3A%2F%2Fapp.yourcompany.com%2Flogin&api_key=jKJViejwijgsajgkasgjsfjasadsfj&subscription=active

Once successfully authenticated and they have an active subscription (if you've put that in the request) we will automatically return them to the reroute URL specified appending the track, user_username and user_password which you can now store the credentials for the user access.

Note: it's important that you still keep the user's credentials and your api_key encrypted to ensure others can't see it in plain sight.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.