GLOBO Mobile Technologies Inc

GO!NotifyLink as GroupWise Trusted Application

File Name: TrustedAppRegistrationDoc.doc

Date / Author / Description of Changes
02/02/15 / Andrew Crown /
Updated screenshots and branding.
04/04/04 / Mike Martin /
Original.

If you have already registered GO!NotifyLink as a trusted application using our update from 3/12/04, then you DO NOT have to register again.

1Introduction

2Registering GO!NotifyLink as Trusted Application

3Registering on a machine other than GO!NotifyLink messaging server

4Toggle Trusted App on / off

5Remove Trusted Application Registration

6Additional Notes

1Introduction

Registering GO!NotifyLink as a GroupWise Trusted Application will allow the GO!NotifyLink messaging and PIM services to login to the GroupWise data store without the need for a password. Specifically, the GleanerController, ResponseMailClient, ResponseHandler, and NotificationController services will be able to get at user mail without a password, and the NLPim service will be able to access user PIM without a password.

The web UI currently still requires that a password be entered when adding a new GO!NotifyLink user. If you are going to run as a trusted app, you can enter whatever you like as the password, as long as you do not leave it blank.

The GroupWise 6.5 client must be installed on the GO!NotifyLink messaging machine in order for the trusted app functionality to work. Because the GroupWise 6.5 client is not backward compatible, it cannot login to access PIM for users on GroupWise 6 servers. Therefore if you have a mixed server environment, you may want to consider this fact when deciding whether to install the GroupWise 6.5 client and registering our trusted application. Also be aware that in our testing, we have noticed a slight throughput issue with the GroupWise 6.5 client, as compared to the GroupWise 6.0 client. For each PIM polling cycle, the first user to login during the cycle may experience a delay of 10-15 seconds to login, when the GroupWise 6.5 client is installed. Each subsequent user should login within a second or two. Please note that these times may vary per your server environment.

For a more technical explanation of GroupWise Trusted Applications, see:

2Registering GO!NotifyLink as Trusted Application

It is recommended that you run the cd installer on the same machine in which you have installed GO!NotifyLink messaging. You must be logged into Netware such that you have administrative rights to the primary GroupWise domain. You can then register as a trusted app by pressing the “Register Trusted Application” button on the installation cd and then the “Register” button. Be sure to follow the buttons in order. Make sure you have first updated your SQL, web, and messaging components first, before you register. If you have already registered GO!NotifyLink as a trusted application using our update from 3/12/04, then you DO NOT have to register again.

Requirement: The machine that the registration application is run on must have the Netware client installed on it. If you do not have Netware client installed on the GO!NotifyLink server and you cannot install it on this machine or do not want to install it on this machine, the registration can be run from another machine. See section 3 for details.

Trouble Shooting note: If you press the “Register” button and get an error that the registration application could not be run, open up a Windows explorer window and browse to the GO!NotifyLink application directory. (“C:\Program Files\Notifylink Enterprise Server”, by default). Ensure that the file RegisterTrustedApp.exe exists. Double-click this file. If it still does not launch, you should be given a more specific error, as to why the application could not be run.

The registration application will prompt you for a path to the primary domain. Provide this path and press the “Register Trusted App” button.

If the application is registered successfully, an application key will be encrypted and stored in the GO!NotifyLink database. A trusted app with the name “GONLES” will be registered with your primary GroupWise domain. It should be viewable via ConsoleOne under “Tools””GroupWise System Operations””Trusted Applications”.

3Registering on a machine other than GO!NotifyLink messaging server

Although it is recommended that you run the registration application on the same machine in which you install GO!NotifyLink messaging, you may run the application on another machine. To do so, you must follow these steps:

  1. When the registration is run, a trusted app key will be returned from the GroupWise server. We encrypt this key and store it into the GO!NotifyLink database. Therefore, the machine in which you register from must have our GO!NotifyLink DSN defined on it. To create our DSN follow these steps:
  2. Go to “Start”“Control Panel””Administrative Tools””Data Sources (ODBC)”.
  3. Choose the “System DSN tab and then “Add”. Scroll to the bottom of the list and choose “SQL Server”.
  4. For Name and Description, you may enter “NLSQLServerDSN”. For Server, choose the server in which you have installed the GO!NotifyLink database, and then press “Next”.
  5. Choose the “With SQL Server authentication…” radio button. For Login ID and Password, enter “NLSQLServerDSN” for both ,and press Next.
  6. Make sure the default database is set to “NLES_IMAP4_POP3” and then choose “Next”.
  7. Press “Finish”. The DSN is now created. You may test the data source to confirm that the DSN was created correctly.
  8. Make sure that you are logged into Netware with admin rights to the primary GroupWise domain.
  9. Launch the registration application from the installation cd and run it as described in the top of this section.

4Toggle Trusted App on / off

This version does not allow for turning trusted application mode on or off via the web interface. When you register as a trusted application, GO!NotifyLink will automatically switch the trusted app flag to “on”. If you would like to make a change to this value, open the GO!NotifyLink database “NLES_IMAP4_POP3” and go to the table “GeneralConfig”. The value you will want to toggle is “TrustedAppEnabled”. 1 signifies “on” and 0 signifies “off”. (For MSDE users, -1 will define “on”, while 0 is still “off”)

5Remove Trusted Application Registration

Uninstalling the GO!NotifyLink software will not currently unregister GO!NotifyLink as a trusted application. A future release of our software will provide a way to remove the GO!NotifyLink trusted app, but for this current upgrade you can remove GO!NotifyLink as a trusted app via ConsoleOne.

To do so, go to ConsoleOne under “Tools””GroupWise System Operations””Trusted Applications”. Select “GO!NotifyLink” and press “Delete”. (See graphic from Section 2)

6Additional Notes

  1. Since the trusted application must be registered with the primary domain, it may take some time for the trusted application to be recognized by secondary domains. If your GWIA is on a secondary domain and you are experiencing authorization failures from our services after registering as a trusted application, you may want to disable GO!NotifyLink from using the trusted app functionality for a short period of time (see section 3 on how to do this). After waiting maybe 30 minutes, you can turn the trusted app functionality back on and check to see if the user authorization is resolved.

GO!NotifyLink as GroupWise Trusted Application Page 1 of 7 Modified on February 2, 2015