//
// Licensed to the Apache Software Foundation (ASF) under one
// or more contributor license agreements.  See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership.  The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License.  You may obtain a copy of the License at
//
//   http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied.  See the License for the
// specific language governing permissions and limitations
// under the License.
//

// Quick reference: http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
// User manual: http://asciidoctor.org/docs/user-manual/
// Tricks: https://leanpub.com/awesomeasciidoctornotebook/read

:homepage: https://syncope.apache.org
:description: Several ways to get started with Apache Syncope
:keywords: Apache Syncope, IdM, provisioning, identity management, getting started, tutorial
:!webfonts:
:iconfont-remote!:
:docinfo1:
:last-update-label!:
:sectanchors:
:sectnums:
:sectlinks:

= Apache Syncope - Getting Started
:revnumber: {docVersion}
:toc: right
:toclevels: 4

image::apache-syncope-logo-small.jpg[Apache Syncope logo]

[NOTE]
.This document is under active development and discussion!
If you find errors or omissions in this document, please don’t hesitate to 
https://syncope.apache.org/issue-management.html[submit an issue] or
https://github.com/apache/syncope/pulls[open a pull request] with 
a fix. We also encourage you to ask questions and discuss any aspects of the project on the 
https://syncope.apache.org/mailing-lists.html[mailing lists or IRC]. 
New contributors are always welcome!

[discrete] 
== Preface
This guide shows you how to get started with Apache Syncope services for:

* identity management, provisioning and compliance; 
* access management, single sign-on, authentication and authorization;
* API gateway, secure proxy, service mesh, request routing.

include::introduction.adoc[]

include::systemRequirements.adoc[]

include::obtain.adoc[]

include::movingForward.adoc[]
