When GeneXus Access Manager is activated (Enable Integrated Security property is set to TRUE), the GAM external objects that interact with the GAM API are always consolidated, but importing the Web Front-end examples and GAM SD examples into the KB is optional.
So, after enabling Integrated Security in the KB, a "GAM Activation Process" dialog box is displayed asking the user to choose whether to import the objects that are part of the GAM Examples front-end and the example objects for Smart Device applications.
The user can also configure if he wants these examples to be automatically updated when a new build or upgrade of GeneXus is installed or if he wants to be prompted for it.
GAM objects are distributed in three:
- GAM API. It is always updated in the KB.
- Web frontend objects.
It refers specifically to the objects that are part of the GAM exmples. It includes the Login Object for Web example and the Not Authorized Object for Web example. These are necessary to start using GAM in web applications.
- Smart Device Configuration.
Examples of Smart Devices objects (SDPanels). They are imported to handle login and authorization in SD applications. Some of these examples are GAMSDLogin object, and GAMSDRegister object. These are necessary to start using GAM in Smart Devices applications.
Upon activating GAM in the KB (set Enable Integrated Security property = True ), the following dialog box is displayed:
Three settings should be selected here:
- Web frontend object is a check box to indicate if the Web Front-end examples is to be imported.
It is checked by default because importing these objects is highly recommended. The Login Object for Web property and Not Authorized Object for Web property are initialized. The Carmine Theme is used by the GAM Examples so it's imported with the rest of the objects.
- Smart Device Configuration is a check box to indicate if the GAM SD examples are to be imported.
If the KB has a Smart Device generator this property is checked by default. If this option is checked, Login Object for SD property, Change Password Object for SD property, and Not Authorized Object for SD property are initialized.
Note that the Smart Device Configuration check box is disabled if the Smart Device Generator is not present in the environment.
If none of the above are selected, only the GAM API is updated in the KB.
3. The combo box is used to indicate how to handle the updates to those examples. The options are as follows:
- Prompt me to update: A dialog box will be displayed when a new version of the examples is found.
- Install updates automatically: The examples will be imported every time a new version is found.
- Never update: No examples will be imported.
To confirm these options, use the Install button.
In a brand new KB, the first time that GAM is activated, this functionality makes it possible to consolidate only what’s necessary. If the KB is only web-based, you have the possibility to not consolidate SD examples.
The options selected in the dialog of figure 1. can be changed from the menu Tools/GeneXus Access Manager/Installation Settings.
The update button imports the newly selected option(s) and saves the changes. This is for changing the settings and applying those changes.
The repair button forces a full import of the GAM API, and all the selected options, not only the new selections.
By using the GAM Settings dialog in a new KB that will be started from GeneXus Server from a KB in which GAM is already activated you have the option to not consolidate the GAM examples.
In a KB where GAM is used only for the web, and you want to start using it for SD, you have the option to apply GAM to the SD part of the KB using this dialog (consolidate the GAM SD examples and initialize Login Object for SD property, Change Password Object for SD property, and Not Authorized Object for SD property).
New GeneXus versions may include updates to GAM Examples. If you selected to automatically update GAM examples (see “Prompt me to update”), the following dialog may appear when updates are available.
Figure 3. Do you want to continue with update of 'GAM' frontend object?
The dialog box lets you confirm if you want to install the updates or not. Select Yes to install them or No if you do not want to at this time.
Updates to GAM examples may be manually installed at a later time by importing GAM_Panels-for-SD.xpz and/or GAM_Frontend.xpz located in folder \Library\GAM under the GeneXus installation directory.
As stated above, the GAM API is not affected by these properties; they are automatically imported every time that a new version is found while the GAM is activated.