SecSignID Confluence Rest API OAuth

2018-03-20 9 minutes to read
Tutorial Index

2-Factor-Authentication for Confluence Rest API OAuth

The following tutorial describes the configuration to use Two-Factor Authentication with SecSign ID Plugin on a third party application using Confluence REST API

Overview

Overview & Quickstart

Confluence is a web application for operational project management as well as for error management and troubleshooting. There are many 3rd party apps available, which can access Confluence, to post, update or modify content. Many companies maintain their own on-premise solutions, to access Confluence data in their own applications.

Those 3rd party applications use the Confluence REST API to exchange information. The following tutorial describes why you should set up OAuth with SecSignID to secure your Confluence REST API.

SecSign ID is a plugin for real two-factor authentication (2FA) for Confluence. 2FA adds another layer of security to your installation by using a second token. In this case the physical token is your smartphone.

If you seek for more information about about two-factor authentication have a look at the Confluence Marketplace.

ATLASSIAN OVERVIEWConfluence OVERVIEW

Login options

Login options with Confluence REST

The Confluence REST API is the primary way to interact with Confluence remotely, whether you are building an app, scripting interactions with Confluence or developing any other integration:

OAuth Authentication

If you are integrating directly with the Confluence Cloud REST APIs it is recommended to use OAuth authentication method. The OAuth authorization framework enables a third-party application to obtain limited access to Confluence resources. The third-party apps won’t store protected data like user passwords or credentials. OAuth is the recommended way to authenticate users to the Confluence REST API. Read more about OAuth and SecSignID

Basic Authentication

For implementations with low security requirements, such as scripts and bots, it is possible to use Basic authentication method. It utilizes just plain old user credentials with name and password. Those credentials are transmitted in plain text and pose a security risk.

Configuration

Configuration

A great starting guide to the Confluence REST API with OAuth authentication is described in the Confluence Developer Tutorial:

Confluence REST OAuth Doc

After Confluence was set up properly, you have to register your 3rd party application under Administration > Applications > Application links.

Your client will require the following URLs to be able to make authentication requests to Confluence:

OAuth Config Value
request token url Confluence_BASE_URL + /plugins/servlet/oauth/request-token
authorization url Confluence_BASE_URL + /plugins/servlet/oauth/authorize
access token url Confluence_BASE_URL + /plugins/servlet/oauth/access-token
OAuth Client

OAuth Client

The third-party app or client can be in whatever language you prefer, it just needs to implement the OAuth protocol. OAuth offers a collection of libraries and services that support OAuth 2.0 for common languages like Java, Php, Swift, Python, Ruby and so on.

At the moment Oauth 2.0 is only available for Atlassian Connect add-ons. For REST API calls, only Oauth is supported.

The Confluence Tutorial also offers an example client (rest-oauth-client-1.0.one-jar.jar) in java. You can find example clients in Perl, Php, Python, Ruby etc. in the bitbucket repository.

SecSignID Plugin needs to be installed in your Confluence instance. Follow the instructions to set up SecSignID in Confluence:

Confluence SecSign Tutorial

Refer to the Confluence Tutorial OAuth on how to obtain a request token with the example client. After obtaining the request token from Confluence, you will get the access URL. The user needs to open the URL, in a browser or internal web view, to authenticate with Confluence. If the SecSignID plugin is set up correctly, your users will be able to authenticate via their SecSignID.

Confluence will ask, if you give the third-party app the permission to read and write content under your account. After approving the access, Confluence will confirm that you have successfully authorized the access. It gives a verification code which you’ll need to get the access token like described in the Confluence Tutorial.

No Patch Work Solutions:
Two-Factor Authentiacation for all your Atlassian services.

Atlassian

Logo
Secure your Confluence system with SecSign Two-Factor Authentication.
Logo
Secure your Jira system with SecSign Two-Factor Authentication.
Logo
Secure your Crowd system with SecSign Two-Factor Authentication.
Logo
Secure your Bitbucket system with SecSign Two-Factor Authentication.
Logo
Secure your Bamboo system with SecSign Two-Factor Authentication.
Logo
Secure 2FA for Identity Federation with Active Directory.
Logo
All Atlassian Plugins can be secured with our SecSign-SAML-Plugin.
Logo
Secure all interfaces between your Atlassian system and external apps with our OAuth Plugin.
Logo
Secure your REST interfaces with SecSign Two-Factor Authentication.

Why SecSignID?

Die 2FA von SecSign ist die stärkste Zwei-Faktor-Authentifizierung auf dem Markt! Profitieren Sie von unbegrenzten Möglichkeiten der Integration. Für so gut wie jedes Login bietet SecSign eine Absicherung. Auch für komnplizierte Nutzermanagement-Situationen, wie beispielse Nutzer in und außerhalb eines AD hat SecSign unkomplizierte Lösungen parat.

Logo

Inhouse- oder Cloudlösung

Zwei-Faktor-Authentifizierung in der Cloud, oder volle Kontrolle und individuelle Anpasungen durch eine Inhouse Lösung.
Logo

Sichere Authentifizierung

Passwörter sind nicht sicher. Sichern Sie Ihre Logins und somit Ihre Unternehmensdaten mit unserer echten Zwei-Faktor-Authentifizierung ab.
Logo

Schützen Sie ALLE Logins

Integration in sämtliche Loginumgebungen; Web, Lokal, VPN, Remote Desktop, Mobile Logins und Plugins für nahezu alle Umgebungen.
Logo

Einfache Integration

Unsere Plugins lassen sich leicht in Ihre Systeme integrieren und ohne großen Aufwand auch für eine große Nutzerzahl aktivieren.
Logo

Unkompliziertes Nutzermanagement

Schützen Sie Ihr Active/Directory/LDAP mit der Zwei-Faktor-Authentifizierung und erstellen Sie dadruch Ihr individuelles Identitäts- und Zugangsmanagement mit zahlreichen Sicherheitseinstellungen.
Logo

App Integration

Mit unserer Anwendungsfertigen SDK können Sie ganz einfach die Zwei-Faktor-Authentifizierung in bestehende Apps integrieren. Alternativ erstellen wir eine App mit Ihrem Unternehmens Look-and-Feel.

Your own ID-Server

On premise installations of SecSign ID offer the flexibility to connect with your preferred servers, services, and devices. And you can customize the SecSign ID with your own organization’s branding.

Learn More
On Premise 2FA ID

Latest Blog Posts, Updates & Features

Atlassian JIRA and Confluence Two-Step Authentication and IP-SafeZone

With SecSign ID you can protect all your logins with a secure Two-Factor Authentication based on a challenge response. The authentication offers the highest protection for the company data while being incredibly simple to us ...

Mehr Lesen

SSO Setup with Crowd

Content Pre-requirements Setup and configuration of the components as a server application Configuration of Crowd for the centrally organized user management Configure application (for example JIRA) to be used wit ...

Mehr Lesen

What is possible with Crowd?

The SecSign ID Crowd Plugin can be integrated in just a few steps. For more information about the plugin and the integration please refer to the following pages. Do you have any questions? Don't hesitate to contact us. ...

Mehr Lesen