DRACOON for Mac: Network installation

This document describes how to preset a specific DRACOON server address in DRACOON for Mac so that end users in your corporate environment do not have to specify it themselves.

Preset server: Prepare and roll out bookmark file

So that a connection can be made with your DRACOON server, its Internet address must be registered in DRACOON for Mac. This is done by creating a so-called new bookmark in DRACOON for Mac.

If there is no bookmark when the program is started for the first time, DRACOON for Mac automatically displays the dialog box for specifying the server settings (and thus for creating a bookmark).
With the automated installation in the network this is possibly undesirable - it should be sensibly already installed a bookmark, so that not every user must indicate the server address himself, but can connect without detours with the intended DRACOON.

The solution: Create a bookmark file that serves as a template and is automatically rolled out to the Macs of your users after installation.

To do this, proceed as follows:

1. Install DRACOON for Mac on a test Mac.
2. Launch DRACOON for Mac.
3. The dialog box for specifying the server settings is displayed (Creating a new bookmark).
   
   • Enter the Internet address of your DRACOON in the Server field.
   • Click OK to save the settings as a bookmark file.n.
4. Locate the file where the bookmark was saved.
   To do this, open the following folder:
   ~Library/Group Containers/G69SCX94XU.duck/Library/Application Support/DRACOON/Bookmarks
     Pfad kopieren
5. In the folder you will find one or more bookmark files (file extension .duck). To check, open the last changed file in the folder with an editor.
6. A file in XML format should be displayed as follows:
   
   • In the line below <key>Hostname</key> (outlined in red above) should contain the server address you entered.
   • Important: The line below  <key>Protocol</key> must read mandatory <string>dracoon</string> - don't change the name dracoon. Also, the line below  <key>Provider</key> has to be named absolutely<string>dracoon-oauth</string>  – also this value must not be changed.
   • The long number combination below the line <key>UUID</key> is generated automatically when a bookmark is created and is different each time. It is used to uniquely distinguish individual bookmarks on a computer and may exist identically on multiple computers. Therefore, a bookmark with a specific UUID can be rolled out to multiple Macs without any problems.
7. If the information is correct, copy the .duck file to another folder. Please do not change the default file name, otherwise the bookmark might be created multiple times on each Mac.
8. Roll the generated file into the bookmarks folder via Active Directory  (e.g.~Library/Group Containers/G69SCX94XU.duck/Library/Application Support/DRACOON/Bookmarks) on any desired Mac.
9. After installation, the existing bookmark file will be recognized the next time the program is started, and to connect the user only needs to enter his username and password in the web browser, which will open automatically when logging in - the server address is already preset.
   Note: The new bookmark file is recognized at the next program start as soon as it is present, even if DRACOON for Mac is already installed. So it is possible to roll out an additional bookmark file at any time afterwards, even if DRACOON for Mac was already installed and in use on user Macs.