Copyright (c) 2005 - 2022 Franz, Incorporated

Last updated 10 October 2022 at 10:17

• Documentation Index
  • Release Notes
  • Quick Start
  • SSL/TLS Quick Start
  • Introduction
  • Setup and Configuration
    • Download
    • Server Installation
    • Server Configuration and Control
    • WebView
    • Database Upgrading
    • Managing Users
  • Server Management
    • Performance Tuning
    • Deleting Duplicate Triples
    • Purging Deleted Triples
    • Auditing
    • Managing Users
    • Replication
    • Point-in-Time Recovery
    • Transaction Log Archiving
    • Security Overview
    • Security Implementation
  • Tools
    • agtool
    • Data Loading
    • Data Export
    • Backup and Restore
    • Querying
    • RDFS++
    • Materializer
    • Event Scheduler
    • SHACL
  • Details
    • Triple Indices
    • Freetext Indices
    • Encoded IDs
    • Connection Pooling
    • N-dimensional Geospatial Overview
    • 2-D Geospatial
    • Temporal
    • Social Network
    • JavaScript
    • Datatypes
    • Data Conversion (Rapper)
    • Stored Procedures
    • Triple Attributes
  • Querying
    • SPARQL documentation summary
    • SPARQL Reference
    • SPIN
    • SPARQL Magic Properties
    • Prolog
  • 3rd-party tools
    • Solr text Indices
    • MongoDB integration
    • TopBraid Composer Plugin
    • Cloudera
  • Client APIs
    • Gruff
    • REST/HTTP interface
    • HTTP reference
    • Javadocs (Sesame and Jena)
    • Python API
    • Lisp Reference
    • JavaScript
  • Tutorials
    • N-dimensional Geospatial
    • SPARQL Tutorial
    • Java Sesame
    • Java Jena
    • Python Sesame
    • Lisp
    • Prolog
    • More...
  • Other
    • Conferences and Seminars
    • Source Code on Github
    • Amazon EC2
    • Copyrights
    • Change History
  • Franz, Inc.

Introduction

Communication with the AllegroGraph server is via AllegroGraph’s RESTful interface. All commands to the server are translated into HTTP statements which are transmitted to the server, and responses are transmitted back in the same fashion.

Administrators have the option of specifying that communication occurs with just ordinary security (usernames and passwords, and users having specified permissions which permit or deny access and actions) or all that plus enhanced security.

Enhanced security comes from using a SSL/TLS interface. AllegroGraph supports two way SSL/TLS, with certificates on both sides.

In this document we describe how to set up an AllegroGraph server to use SSL/TLS and to be accessed with an https URL.

(Some programs that are run on the same machine and by the same user as the server do communicate directly with the server rather than through the REST interface.)

Assumptions

We assume that

1. You have a server certificate and a private key.
2. You have configured your clients to trust the server certificate.

Configuration steps

1. Copy the PEM-encoded server certificate and unencrypted private key into a single file.

2. Ensure the configuration file (normally lib/agraph.cfg) includes values for the following (configuration directives are documented in the Server Configuration and Control document):

# The port number to use for HTTPS.  
SSLPort [Integer suitable as a port number]  
# The path to the file containing the PEM-encoded server  
# certificate and private key.  
SSLCertificate [PATH TO SERVER-CERT-AND-KEY.PEM] 

The SSL Port will be active when you start (or restart) the AllegroGraph server.

You can have both a SSLPort and a regular port, such as having these lines in the agraph.cfg file:

SSLPort 10036  
Port 10035 

The server will listen on both ports, the first accessed with https and the second with http.

Testing

Assuming the SSLPort number is 10036, i.e. agraph.cfg contains the line

SSLPort 10036 

execute the following curl command (replacing 10036 with the actual SSLPort number if different):

curl -k https://[HOST]:10036/version 

where [HOST] identifies the machine running the server (use localhost if running curl on the same machine as the server). If the SSL/TLS connection is working, the version of AllegroGraph (7.3.0) will be printed.

Other SSL/TLS configuration directives

See the section Top-level directives for SSL client certificate authentication in the Server Configuration and Control document for other configuration directives associated with SSL/TLS.