COLNEO Authentication

The COLNEO Authentication module provides comprehensive Identity Management, Authentication, and web applications for user login and registration.
It consists of two main components: a set of web services for managing user identities, and web applications that enable users to login, register and access their personal data.
Additionally, the Authentication module handles the provisioning and management of licenses.

Registration and Login

Quick reference links to all authentication pages and their specific purposes.

View URL Purpose
Login https://idp.colneo.services/cnapp_login Full login with registration links
https://idp.colneo.services/cnapp_login?register=false ↳ Login only, no registration links
https://idp.colneo.services/cnapp_login?user=[email] ↳ Login with user email in query parameter
https://idp.colneo.services/cnapp_login?redirect=[URL_ENCODED] ↳ Login and redirect to external application
Registration https://idp.colneo.services/cnapp_login/register User registration form
Email Confirmation https://idp.colneo.services/cnapp_login/email-confirm Email address confirmation
Forgot Password https://idp.colneo.services/cnapp_login/forgot-password Request password reset code
Reset Password https://idp.colneo.services/cnapp_login/reset-password Reset password with code
Accept Invitation https://idp.colneo.services/cnapp_login/accept-invite Accept organization invitation

Web Service

Web Service IDP provides endpoints to manage identities.
See more details here : ... /cn_documentation/cn_api_REST/idp/

Web Application

The web application 'cnapp_login' provides an interface to register and login to infohub.
See web application here: WebApp cnapp_login

1. User Registration

Create a new account to access the system with email verification required.

Registration Process

Registration link: https://idp.colneo.services/cnapp_login/register

New users must register before they can access the system:

  1. Navigate to Registration: Click "Kein Konto? Registrieren" from the login page
  2. Fill Required Information:
    • Name (required)
    • UserID (Email address - required)
    • Password (required)
    • Confirm Password (required)
  3. Accept Terms: Check both required checkboxes:
    • Accept Terms and Conditions (AGB)
    • Accept Privacy Policy (Datenschutzerklärung)
  4. Submit Registration: Click "Registrieren" button
  5. Email Confirmation: You will receive a confirmation email
Note: After registration, you must confirm your email address before you can log in.
Registration Requirements

2. Email Confirmation

Verify your email address using the confirmation code sent after registration.

Confirmation Process

email-confirmation-link: https://idp.colneo.services/cnapp_login/email-confirm

After registration, confirm your email address:

  1. Check Email: Look for confirmation email in your inbox
  2. Navigate to Confirmation: Click the link in the email or go to email confirmation page
  3. Enter Details:
    • UserID (Email address)
    • Confirmation Code (from email)
  4. Submit: Click "Email bestätigen" button
  5. Success: You can now log in with your credentials
Resend Confirmation Code

If you didn't receive the confirmation email:

3. User Login

Access the system with your credentials.

Login Process

login-link: https://idp.colneo.services/cnapp_login/

Once your email is confirmed, log in to the system:

  1. Navigate to Login: Go to the login page
  2. Enter Credentials:
    • UserID (your registered email address)
    • Password
  3. Submit: Click "Anmelden" button
  4. Success: You will be authenticated and redirected
Hide Registration Links

If you wish to hide the registration links, you can use the register query parameter.
https://idp.colneo.services/cnapp_login?register=false

Login with User Email

If you wish to login with a user email, you can use the user query parameter.
https://idp.colneo.services/cnapp_login?user=[email]

Redirect Parameter Integration

The authentication system supports a redirect query parameter for seamless third-party application integration:

How it Works
  1. External App Redirects: Your application redirects users to the login page with a redirect parameter
  2. User Authenticates: User logs in successfully
  3. Automatic Return: System automatically redirects back to your application with authentication tokens and UserID
URL Format

https://idp.colneo.services/cnapp_login?redirect=[URL_ENCODED_DESTINATION]

Examples
Scenario Login URL After Login Redirect
Simple Redirect ?redirect=https%3A//myapp.com/dashboard https://myapp.com/dashboard?token=abc123&user=user@email.com
URL with Existing Params ?redirect=https%3A//myapp.com/page%3Fid%3D123 https://myapp.com/page?id=123&token=abc123&user=user@email.com
Implementation Guide

To integrate with your application:

  1. URL Encode: Encode your destination URL using encodeURIComponent()
  2. Redirect to Login: Send users to https://idp.colneo.services/cnapp_login?redirect=[YOUR_ENCODED_URL]
  3. Handle Return: After login, users return to your URL with:
    • token - Authentication token
    • user - User email address
  4. Extract Tokens: Parse the URL parameters to get authentication data

4. Password Reset

Reset your password using email verification code when you can't access your account.

Forgot Password Process

forgot-password-link: https://idp.colneo.services/cnapp_login/forgot-password

If you forgot your password:

  1. Access Reset: Click "Passwort vergessen?" from login page
  2. Request Code: Enter your UserID (email) and click "Reset-Code senden"
  3. Check Email: You'll receive a reset code via email
  4. Reset Password: Enter:
    • UserID (Email address)
    • New password
    • Confirm new password
    • Reset code from email
  5. Password Reset Page: https://idp.colneo.services/cnapp_login/reset-password
  6. Submit: Click "Passwort zurücksetzen"
  7. Success: You can now log in with your new password

5. Accept Invitation

Join a project or group using an invitation link sent to your email.

Invitation Process

accept-invitation-link: https://idp.colneo.services/cnapp_login/accept-invite

If you received an invitation to join:

  1. Access Invitation: Click the link in your invitation email or navigate to the accept invite page
  2. Enter Details: Fill in the required information from your invitation
  3. Submit: Click the submit button to accept the invitation
  4. Success: Your account will be activated and you can log in

6. Logout

When logged in, you can securely log out: