FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

Identity Utility

Identity Utility

This is a ColdBox Module with a modest goal of aiding in creating, converting, and validating unique identities. It's not specific to UUIDs, but that's what's implemented currently.


  • Lucee 4.5+ or Adobe ColdFusion 10+
  • ColdBox 4+


Install using CommandBox: box install identity-utility

API Documentation

To generate API documentation (for the one modest component in this project), execute the following: box run-script generate-docs The resulting static files can be viewed in a web browser from identity-utility/apidocs/index.html


To run the tests, execute the following:

box server start
box testbox run

This will fire up an embedded server and run the TestBox spec for the utility, returning the results to the shell.


Within the component you'd like to make use of the Identity Utility, have WireBox inject an instance for you from the module's namespace:

property name="idutil" inject="[email protected]";

Once you have a reference to it, you can retrieve a new UUID using one of these methods:

  • uuid()
  • jvmuuid()
  • cfmluuid()
  • mssqluuid()

You can easily normalize and convert a garbage UUID:

variables.idutil.normalizeUUID("43DC4B19%252D0342%252D42D2%252DA0A1%252D6909B0C7D588", "cfml");

A value can be validated to be a UUID with the specified style:

variables.idutil.validateUUID(uncertainInput, "jvm");

With an instance of the utility, you can persist the desired UUID style:


After specifying the preferred UUID style, calls to uuid() method will use your preference.

See the TestBox test spec at /tests/specs/TestIdentityUtility.cfc for more ideas.


See the LICENSE file for license rights and limitations (MIT).

Here are all the versions for this package. Please note that you can leverage CommandBox package versioning to install any package you like. Please refer to our managing package version guide for more information.

Version Created Last Update Published By Stable Download
1.1.0 Aug 22 2018 08:05 AM Aug 22 2018 08:05 AM Joseph Lamoree (jlamoree)
1.0.0 Sep 04 2016 02:44 AM Sep 04 2016 02:44 AM Joseph Lamoree (jlamoree)


No collaborators yet.
  • Sep 04 2016 02:44 AM
  • Aug 22 2018 08:05 AM
  • 543
  • 12
  • 279