mongo-realm

MongoDB-backed Realm for Glassfish

License	MIT License
Categories	GlassFish Container Application Servers Realm Data Databases
GroupId	com.tadamski.glassfish
ArtifactId	mongo-realm
Last Version	1.0.0-beta-2
Release Date	Jun 17, 2014
Type	pom
Description	mongo-realm MongoDB-backed Realm for Glassfish
Source Code Management	https://github.com/tmszdmsk/mongo-realm

Download mongo-realm

Filename	Size
mongo-realm-1.0.0-beta-2.pom	6 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.tadamski.glassfish/mongo-realm/ -->
<dependency>
    <groupId>com.tadamski.glassfish</groupId>
    <artifactId>mongo-realm</artifactId>
    <version>1.0.0-beta-2</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.tadamski.glassfish/mongo-realm/
implementation 'com.tadamski.glassfish:mongo-realm:1.0.0-beta-2'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.tadamski.glassfish/mongo-realm/
implementation ("com.tadamski.glassfish:mongo-realm:1.0.0-beta-2")

Apache Buildr

'com.tadamski.glassfish:mongo-realm:pom:1.0.0-beta-2'

Apache Ivy

<dependency org="com.tadamski.glassfish" name="mongo-realm" rev="1.0.0-beta-2">
  <artifact name="mongo-realm" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.tadamski.glassfish', module='mongo-realm', version='1.0.0-beta-2')
)

Scala SBT

libraryDependencies += "com.tadamski.glassfish" % "mongo-realm" % "1.0.0-beta-2"

Leiningen

[com.tadamski.glassfish/mongo-realm "1.0.0-beta-2"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

• api
• module

MongoDB-backed realm for Glassfish

With Mongo-Realm you can store your users credentials directly in MongoDB with other data of your applicaton. Forget about setting up separate MySQL or LDAP server only for storing users data.

Setup

1. download mongo-realm jar and put it in your glassfish domains lib folder (i.e. $GLASSFISH_HOME/glassfish/domains/$DOMAINNAME/lib/)
2. at the end of $GLASSFISH_HOME/glassfish/domains/$DOMAINNAME/config/login.conf file paste:

mongoRealm { 
  com.tadamski.glassfish.mongo.realm.MongoLoginModule required; 
};

3. create realm in glassfish using asadmin tool

asadmin create-auth-realm --classname com.tadamski.glassfish.mongo.realm.MongoRealm --property jaas-context=mongoRealm $REALM_NAME

4. configure your applicaton to use newly created realm (in most cases few lines in web.xml will be enough)

Configuration

By default:

Mongo-Realm connects to localhost on 27017 and looks for data in users database in users collection. Informations about users are stored in separate documents [one user = one document]. Each document contains login, password simple string properties and groups with array of group names user belongs to. All passwords are hashed using SHA-512 function.

Salt property is appended to the password before hashing. For users without salt, it will be generated on the first login.

Custom configuration:

Of course defaults can be overriden. Simply add properties to realm created in 3rd step of Setup.

Property name	Default value
mongo.hostname	localhost
mongo.port	27017
mongo.db.name	users
mongo.collection.name	users
login.property	login
salt.property	salt
password.property	password
groups.property	groups
hash.function	SHA-512

Versions

Version
1.0.0-beta-2 Jun 17, 2014
1.0.0-beta-1 Jun 17, 2014