4 Configuration

Basic Configuration

Make sure that you have installed and configured spring-security-core plugin before this step.

Calling 'grails s2-init-vkontakte' will make default configuration of plugin for you, make sure that you have configuration in your Config.groovy like:

grails.plugin.springsecurity.vkontakte.domain.className = '<your VkontakteUser domain>'
grails.plugin.springsecurity.vkontakte.appId = '<Vkontakte appId>'
grails.plugin.springsecurity.vkontakte.secret = '<Vkontakte secret>'

Or you can skip 'grails s2-init-vkontakte' step, and make such configuration by yourself.

When you have valid configuration you can put Vkontakte Connect button in you GSP:

<vkontakteAuth:connect />

Vkontakte configuration

Permissions

See: Vkontakte App permissions

Domain configuration

Where:

• .classname - domain class name that will be used for authentication
• .connectionPropertyName - name of property that connects (belongsTo) to main app user (if you have two different domains, one for app user, one for Vkontakte user)
• .userIdPropertyName - name of property to hold Vkontakte user id

Authentication configuration

Where:

• .autoCreate.enabled - plugin will automatically create corresponding user for each new visitor authentication using Vkontakte
• .autoCreate.roles - default list of roles that will be assigned to create user

Filters configuration

Redirect

Where:

• .filters.redirect.processUrl - url that will be used for authentication
• .filters.redirect.position - filter position
• .filters.redirect.authenticationSuccessHandler - bean name to use as authentication successHandler
• .filters.redirect.authenticationFailureHandler - bean name to use as authentication FailureHandler
• .filters.redirect.successHandler - configuration for predefined handler
• .filters.redirect.failureHandler - configuration for predefined handler

Open API

Where:

• .filters.openApi.processUrl - url that will be used for authentication
• .filters.openApi.position - filter position
• .filters.openApi.authenticationSuccessHandler - bean name to use as authentication successHandler
• .filters.openApi.authenticationFailureHandler - bean name to use as authentication FailureHandler