How do I embed login credentials in a URL?

Updated Oct 10, 2019

Why Would You Want to Do This?

This article will show you how to embed login credentials into a url. Why would you want to do this?  Here is an example scenario:

Say that you have a user area on your own website, not on ScreenSteps. You create a site on ScreenSteps that you want those users to have access to but you don't want to go through the hassle of setting up user accounts for everyone on ScreenSteps. You can use this method to provide a link in the user area that will take them to your site on ScreenSteps and automatically log them in under a shared user account.

What to Do

1. First you will want to create a new API Access account. This account will be the login for everyone from your own site.  In this example we will say that the username is "myusers" and the password is "mypassword".

2. Then add this user to a protected site on your account. They will now have permission to view the site.

3. Copy the url for the site and add on the authentication parameters.

IMPORTANT: Don't copy the url the admin area of your account. API Access users cannot access the admin area. Make sure you copy the public url.

If the url for your space was then you would want to add ?login=myusers&password=mypassword to the end. The result would look like this:

4. Put this link on your own website.  

When a user clicks on this url they will be taken to space 2345 and automatically logged in.  Anybody just going to will be asked for a username and password.


Security Considerations

A few things that you should be aware of:

  1. Anybody who has this url can login to the site.  You may want to update the password periodically.
  2. If you use http instead of https for the url then the url will be sent unencrypted. If someone is sniffing your traffic they would be able to see the username and password in the url.


If you need lock-tight security for your content, then you should create reader accounts for each person that is going to access that content or use Single Sign-on

 But if you just need something simple that will keep unauthorized people out of the site while at the same time make it easy for your authorized users to get access to the content then this can be a good solution.


John Readwin

I have found that if for instance the password contains a punctuation character, then the URL passes it as that character and doesn't not properly encode it ( i.e. ! should encode to %21 but it doesn't and thus the url's break i some browsers.

Trevor DeVore

@John When creating a URL by hand you are responsible for encoding any special characters. Just replace the punctuation character with the encoding form and you should be good to go.

John Readwin

Trevor my bad, perhaps this wasn't the correct article to post to, but the URL issue occurs when using the "Embeded login URL" function in Screensteps live

Mohammed Samiuddin


I am not sure if it is possible but i would like to share for some suggestion how can I achieve it

I have a internet website also I have login account
I have embedded Link in our organization Internal Portal
What I want is Whenever user click the link it should not ask them to login
it should directly take them to the page after login with Successful login

Not Sure if it is possible But Suggestions are welcome

Trevor DeVore

@mohammed - the instructions on this page should do what you are asking. The other alternative is to setup Remote Authentication with ScreenSteps. With Remote Authentication ScreenSteps will authenticate people using your web server.

Nicole Biesenbender

Hi, this method is great and it takes the user to the 'home' page of my Screensteps site. However, I would like them to go to a specific page beyond the 'home' page with embedded login credentials. Is this possible?

Trevor DeVore

@Nicole - the user should be taken to the page your link points to after they login. If it isn't working please contact us through support and we can troubleshoot.

Mark Welton

I have an application running on a separate server that users are required to enter their username and password. Within that app, I want to add a link that takes them to a wordpress web page having their username and password sign them in (to the wordpress site). I am using WP 5.1.
Will ScreenSteps work in this manner? if so, any help you can provide will be apprecitate.
Thank you

Mark Welton

Trevor DeVore

@Mark - Can you clarify where ScreenSteps sits in your design? You mention an application and WordPress but not ScreenSteps.

Add your comment

E-Mail me when someone replies to this comment
Previous Article How do I invite a viewer to a site?
Next Article Enable a Contributor to Modify the Site Template
Still Need Help? Contact Us