Skip to main content

directprint.io Client SSO with Microsoft

James Gilmore
  • Updated

Introduction
Windows environment variables
macOS plist entries

 

Introduction

directprint.io supports SSO with Microsoft. To use this feature you must use Printer Deployment & Allocation with MS Azure.

To ensure that directprint.io can successfully establish a link between your directprint.io account and your directprint.io Azure AD enterprise application, we provide an Azure Sign On code. Your Azure Sign On code can be found here https://directprint.io/admin/azure.

There are two methods by which you can use your Azure Sign On code;

  1. Share it with your users so that they can enter it into directprint.io when signing in via Microsoft and prompted.
  2. RECOMMENDED - Use Windows Environment variables / MacOS plist entries to automate this process for your uses.

Windows environment variables

To silently use the Azure Sign-on code with Windows set the following environment variable via a Group Policy. Here is an example. 

UPD_SIGNON_CODE=uxep

Ensure the code "uxep" is replaced with your organization's Sign-on code.

 

Or set it via Group policy:

UPD_SIGNON_CODEArtboard 1@2x.png

Additionally for Windows Server environments here is an article explaining how to set env-var via group policy:

https://social.technet.microsoft.com/wiki/contents/articles/25972.create-environment-variables-with-group-policy.aspx

 

Sample batch commands to set environment variables

Setting the signon code at the machine level (requires administrator privilege)

setx UPD_SIGNON_CODE uxep /m

 

Setting the signon code at the user level

setx UPD_SIGNON_CODE uxep

 

 

macOS plist entries

To silently use QuickCodes and/or the Azure Sign-on code, take the following steps:

  • When installing the directprint.io application using JAMF or a similar deployment tool you also have the option to install a com.directprint.io.plist file (see attachment) onto the device (N.B. System not User level). 
‘<HardDisk>/Library/Preferences/’
  • Its contents must contain the following (see attached file as an example).
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>UPD_QUICKCODES</key>
    <string>xc12,i2vt</string><!-- change this to contain a list of QuickCodes --> 
    <key>UPD_SIGNON_CODE</key>
    <string>uxep</string><!-- change this to your Azure Sign-on code --> 
  </dict>
</plist>

 

 

 

Related articles