SoftwareCentral · Untrusted domain support

Configuring SoftwareCentral with an untrusted domain

Do this from the trusted domain, before you install SoftwareCentral in the untrusted domain: add the domain, set whether it is trusted and which service account it uses, and enter the SCCM database connection.

Add domain Trusted and service accounts SCCM SQL login

1 Add the domain

Go to Settings › Domain › Domains in SoftwareCentral and check whether the untrusted domain is in the list. Only members of the SoftwareCentral administrator role can add and change domains.

If the domain is not in the list, click Add domain, to the right of the description. Enter the fully qualified domain name in Domain, then set its trust and service account as described in the next step, and click Save.

Refresh only finds trusted domains SoftwareCentral fills the list from the trusted domains in Active Directory while the list is empty, and Refresh at the top of the list adds trusted domains that are new. An untrusted domain is never found this way, so it always has to be added with Add domain.

2 Set trust and service accounts

Each domain in the list shows whether it is trusted and which account SoftwareCentral uses there. To change a domain that is already in the list, click Edit in its row. The window has the fields below.

Settings page with Domain and Domains selected in the menu. The description is on the left with the Add domain button to its right, a Refresh link above the list, and one row: CONTOSO.LOCAL, Trusted ticked, service account CONTOSO\svc-swc, pre Windows 2000 name CONTOSO, port 389, with an Edit and a Delete button.
The Domains tab: Add domain to the right of the description, and Edit and Delete in each row. The values in this picture are masked.
The Add domain window with the fields Domain (example contoso.com), Trusted with the Trusted domain box ticked, Service account, Password, Pre Windows 2000 name (example CONTOSO) and Port set to 389, and the Save and Cancel buttons.
The Add domain window. For an untrusted domain, untick Trusted domain and fill in Service account and Password. Edit opens the same window for an existing domain.
FieldWhat it means
TrustedThe trust is relative to which domain you are using. For this interface, we define the trust relationship from the domain the SCCM server is located in. Tick the box for each domain that is trusted from the domain where the SCCM server is located. Untick it for an untrusted domain.
Service accountThe account SoftwareCentral uses in that domain. All user names must be entered in the following format: domain\username. Required when Trusted is unticked.
PasswordThe password of the service account. Required when Trusted is unticked. When you edit a domain, leave it empty to keep the current password.
Pre Windows 2000 name and PortThe NetBIOS name of the domain and the port that SoftwareCentral uses to connect to it. The default port is 389.

Click Save. The domain is saved straight away; you don’t need to click Save Settings.

If we consider the example on the first page of this document, Domain 3 would be the only untrusted domain. Domain 1 and 2 would need to be ticked in the Trusted column.

A service account is needed in all domains. You can use the standard service account (app-pool user) in all the trusted domains.

In the untrusted domain, a new service account is needed (It has to be the service account running the SoftwareCentral website in the untrusted domain).

A wrong tick changes the account When the SCCM server is in a different domain from the SoftwareCentral web server, and either of the two domains is not trusted, SoftwareCentral connects to SCCM with the service account of the SCCM server's domain. Otherwise it uses the application pool account. So ticking Trusted for a domain that does not trust the other domain makes SoftwareCentral use the application pool account there.

3 Enter the SCCM connection

Next, go to the SCCM connection in Settings › General Settings › Server Configuration. The remaining steps are not needed for SoftwareCentral Cloud.

Settings page with Server Configuration open. The SCCM Server, SCCM Database Server Name, SCCM Database Name, SCCM Database Trusted Connection, SCCM SQL User and SCCM SQL Password boxes are visible. The values are masked.
The SCCM fields in Server Configuration: SCCM Database Server Name, SCCM Database Name, SCCM Database Trusted Connection, SCCM SQL User and SCCM SQL Password. The values in this picture are masked.

All server names must be entered as fully qualified.

The connection to the SCCM database must use a SQL Login. Untick SCCM Database Trusted Connection, then fill in SCCM SQL User (Only needed if untrusted) and SCCM SQL Password (Only needed if untrusted).

Fill in the SCCM Database Connection string as follows:

Server=servername; Database=databasename; User ID=username; Password=password; Trusted_Connection=false;

SoftwareCentral builds the connection from the fields above, so you do not type the string yourself. Enter the server, the database and the SQL login in their fields.

Under SCCM SQL User and SCCM SQL Password you must also enter the SQL Login.

No passwords have to be manually encrypted here.

Click Save Settings when you are done.

Turn off Engineering Mode first You must disable the Engineering Mode in order to do the installation of the new site. An administrator turns it off by adding debug=false to the address of any SoftwareCentral page, for example https://softwarecentral/SettingsPage?debug=false. While it is on, the top right corner shows Debug Mode Enabled.

4 Create the administrator role

Now a Security Role is needed for the untrusted domain. Create an Administrator role with full access.

You might need to type in the AD-Group name of the administrator group manually in the Create Security Role interface, as the drop-down won't return any AD-Groups.

All other roles in the untrusted domain should be created from SoftwareCentral in the untrusted domain.

5 Best practice

  • Add the untrusted domain with Add domain. Refresh only finds the domains Active Directory trusts, so an untrusted domain has to be added by hand, with its service account and password.
  • Tick the Trusted box only for domains that really are trusted from the SCCM domain. A wrong tick makes SoftwareCentral use the wrong account for SCCM, as the note in section 2 explains.
  • Enter every account as domain\username, using the account that has the rights in that domain. Keep the password under the policy of that domain, and update it in SoftwareCentral when it changes.
  • Use a SQL login when the SCCM database is in an untrusted domain. Untick SCCM Database Trusted Connection and enter the login in the two SQL fields.
  • Turn Engineering Mode off for a production install. While it is on, SoftwareCentral writes more detail to the log and shows the Debug Mode Enabled label.