Skip to main content
Version: 2.82.x.x LTS

Terms and conditions

The terms and condition concept in nevisIDM is used to keep track of terms and conditions accepted by users. The concept has two main elements: Terms and Consents. These elements and their relations are described in the following sections.

Terms and conditions model

There is a many-to-many relationship between applications and terms. An application can have assigned one or several terms, for example, privacy policy, legal terms, and so on. Vice versa, several applications can use the same terms. A consent object is created when terms are accepted by a user. The consent object links the user to the accepted terms. It stores the current version of the terms and the date when the terms are accepted.

nevisIDM terms and condition model

Terms object

The terms object stores everything related to terms.

AttributeTypeDescription
extIdString(129)External identifier.
nameString(255)The name of the terms.
termsVersionString(255)The version of the terms.
activeBooleanDetermines whether the terms are active or not.
silentAcceptanceBooleanDetermines whether the terms are accepted silently or not. If the attribute silentAcceptance is set to "false", a user must explicitly accept new versions of the terms.
urlsMapA key-value map storing the URLs of the terms.
key: A string denoting the language of the terms.
value: A string denoting the URL of the terms resource.
The actual terms resource is not persisted by nevisIDM but must be provided from an external content management system.
applicationsSet of applicationsThe set of applications that are assigned to the terms.

The consent object stores the acceptance of a terms by a user. This includes details such as the point in time the user accepted the terms, or the version of the accepted terms and conditions.

AttributeTypeDescription
userUserThe user who gave consent to a specific terms.
termsTermsThe terms a user gave consent to.
termsVersionString(255)The version of the terms the user gave consent to.
acceptanceDateDateThe date the user gave consent to the terms.

Administration

You can currently only administer terms and conditions as well as consents over the REST API. The following operations are supported:

  • Creating, getting, modifying and deleting terms.
  • Assigning an application to a terms/ unassigning an application from a terms.
  • Accepting terms for a user, that is, creating a consent.
  • getting all active pending terms for a user, that is, all the terms a user has not yet accepted for the current version.

See the separately available REST API documentation for more details:

  1. Go to Nevis Documentation homepage.
  2. Download the api ZIP file for your nevisIDM version.
  3. Inside the ZIP file, open core.html and navigate to the section: Terms REST Service.

Usage

For use cases and configuration, refer to Terms and conditions use cases.