Collapse All Expand All

All of the following technical work must be performed when handling the click event described in Step 2 on the User Experience page:

Step 1 The payroll system used by your company stores an “EmployeeID” for each employee and a “CompanyID” for each of your companies. The EmployeeID and CompanyID for the currently logged-in employee must be determined.

Step 2 An https connection must be made to a Greenshades Authentication Webservice. Please note that because the web service is accessed through https, all information is sent over an encrypted SSL connection, so no data will be viewable to an outside source. The WSDL (Web Service Definition Language) file is located here.

Step 3 The web service’s AuthenticateEmployee3 method must be called with several parameters:

1 AuthenticationKey: a private identifier provided to you by Greenshades once you express interest in pass-through authentication.  May be a static or rotating key.

2 GSCompanyID: An integer that Greenshades uses to refer to your company, a.k.a. ParentCompanyId

3 OurCompanyID: The companyID discovered in Step 1, i.e. 'TWO'

4 EmployeeID: The EmployeeID discovered in Step 1, a.k.a. EmployeeNativeId

5 TargetPortal: This will be the string "GreenEmployee." 

6 IPAddress: The IP Address of the computer making the SOAP call, tracked for reporting.

7 UserAgent: The user agent of the computer making the SOAP call, tracked for reporting.

Step 4 This method will return a URL. The URL itself will contain a session ID that will be valid on Greenshades’ logon servers for the next 30 seconds. (Once a login occurs, the employee will be able to use the GreenEmployee portal for some time before they are logged out). The URL will be in the following form: https://[companycode].greenemployee.com/default.aspx?s=[SessionID]

Step 5 You may now either redirect to the provided URL or open up a new window targeting that URL.