RapidIdentity Product Guide

Data

Data contains five interfaces to allow administrators to perform four key functions.

  1. Export the current RapidIdentity configuration.

  2. Import a previously exported RapidIdentity configuration.

  3. Update libraries to support or remove drivers.

  4. Manage public images.

The five interfaces are named to match their functions above.

Export Migration Archive

Export Migration Archive allows an administrator to download a zip file of the current RapidIdentity configuration.  

Note

RapidIdentity does not currently support backing up a database that points to Microsoft SQL Server.

RapidIdentity Configuration backups can include all configuration files, database and audit tables, and shared files. Administrators can export the configuration at any time and choose a configuration export to match their organization's backup and restore policy.

Export_Migration_Archive.jpg

The downloaded zip file can then be stored in a backup repository as well as imported into a new RapidIdentity appliance.

Follow these three steps to export the current RapidIdentity configuration.

  1. Navigate to Configuration > Systems > Data > Export Migration Archive.

  2. Determine whether the export download should include the database configuration, audit tables, or shared files. Check any necessary checkboxes.

  3. Click Start Export.

The zip file export and download process should begin immediately and the resultant file should be stored in the browser's configured location for downloaded files.

Import Migration Archive

The Configuration > Systems > Data > Import Migration Archive menu allows administrators to import RapidIdentity files that have been exported previously.

Note

RapidIdentity does not currently support importing database data from an export if pointed to a Microsoft SQL Server.

Database data can only be imported into the same kind of database (e.g. MySQL, PostgreSQL) as the database from which it was exported.

Import_Migration_Archive.jpg
  1. To import RapidIdentity configuration files, first click Select Migration Archive and navigate to the required .zip file.

  2. The screen will update to show which parts of the import are affected by the .zip file. Click the checkboxes next to the sections to be updated by the new import.

    Import_Migration_Archive_wSelections.jpg
  3. Click the newly activated Start Import. A warning will appear, advising that this is a permanent action. Press Cancel to back up or Start Import to commit.

    Start_Import.jpg
  4. After the files import, a dialog box will display to begin the restart. Click Restart Server; the server will come back online in a few minutes.

Libraries

Libraries are the interface to manage drivers such as JDBC. 

Libraries_-_Main.jpg

Existing libraries and drivers display as a list with a checkbox and filename column header. An existing library can be removed at any time by clicking the corresponding checkbox and then clicking Delete. Once the Delete button is clicked, the library is removed immediately without a confirmation window to confirm the deletion.

Libraries can be added at any time. Follow these steps to add a new Library or Database Driver.

  1. Click Add Library + and select the appropriate file by clicking Choose File

    Note

     It is important to understand that RapidIdentity adds a placeholder for the library that will be uploaded. This placeholder is called New File. Once the Library is selected from the workstation location, the filename of the library replaces New File

    Add_New_Library.jpg
  2. Select the file and click Upload Library

  3. When the upload process is complete a green notification appears as confirmation that the upload and installation succeeded.

    Library_Upload_Successful.jpg
  4. To delete a library, simply select the checkbox next to it and click Delete. There will not be a confirmation popup.

    Delete_Library.jpg
Images

The Images interface allows organizations to upload a custom image that can be used throughout RapidIdentity for branding purposes. 

Note

While RapidIdentity supports a public images feature, if this feature is used heavily in an environment with high traffic, it can cause performance degradation.

Hosting images in a CDN or other server optimized for serving static files is recommended for high-traffic environments.

Images.png

Once an image is uploaded, a URL is generated and this URL can be used for custom CSS enhancements. In this particular screenshot, the public URL is obscured for security reasons; however, the URL takes the following form:

https://<Hostname or IP address>:443/files/<filename>

To upload an image, click Add Image +. Then click Choose File and select the desired image.

To delete an image, check the box next to the image(s) to be deleted. Then click Delete Selected Files and click OK.

Image files can be uploaded or deleted at any time.