SoftwareCentral · Web services

Configure Anonymous or Basic Authentication

Set up an extra IIS site for the web services that uses Anonymous or Basic Authentication.

IIS Manager Same application pool HTTPS for Basic

1 Before you start

This guide sets up an extra IIS site for SoftwareCentral that uses Anonymous or Basic Authentication.

The main interface of SoftwareCentral cannot be reached anonymously. Only the HTA and the web services are available this way. An extra site created like this adds no steps when you update SoftwareCentral.

2 Create the site

Go to the server where SoftwareCentral is installed, open the IIS Manager, go to the Sites tab and click Add Website...:

IIS Manager with Add Website in the menu of the Sites node
IIS Manager › Sites › Add Website...

A new window opens:

The Add Website window
The Add Website window.
  1. Enter a name for the new site.
    The Application pool field with the same pool as the original site
    Select the same application pool as the original SoftwareCentral site.
  2. Select the path to the installation folder of the original SoftwareCentral site.
    The Physical path field
    The Physical path is the installation folder of the original site.
  3. Create a binding. You can use a host name, or the server name with a port number.
    The Binding section with host name and port
    The binding that callers use to reach the site.
  4. Click OK to save the site.

3 Choose the authentication

Open the Authentication feature of the new site:

The Authentication list of the new site
The Authentication list of the new site.

Enable Anonymous Authentication or Basic Authentication, and disable all the others:

Only one authentication method enabled
Only the one you need is enabled.

The site is now ready and needs no further configuration.

Basic Authentication Only web services support Basic Authentication. The credentials must belong to an Active Directory user who is a member of a security role with access to the web services. Basic Authentication sends the credentials in clear text, so configure the site with HTTPS.
Then turn it on per web service For anonymous access, also tick Enable anonymous access on the Security tab of each web service that may be called without a user. See Security.

4 Best practice

  • Allow anonymous access only on the web services that need it. The setting is made for each web service, and a service without it refuses anonymous calls.

5 Troubleshooting

SymptomCauseWhat to do
“Anonymous authentication is disabled for this web service.” The call came through the anonymous site, but Enable anonymous access is not ticked for that web service. Tick Enable anonymous access on the Security tab of the web service.
“Access denied.” SoftwareCentral does not authorise the account that made the call. Check that the account is allowed to use SoftwareCentral web services.