SyncApp Authentication Service

Module Overview

The sync-app-authentication service is a focused microservice responsible for all data source lifecycle operations: create, authenticate, delete, list, and reset. This module clarifies the often-confused distinction between sync-app-authentication (data source management) and sync-app-oauth (PMS OAuth token management), and walks through the authentication service's key methods including its cache-backed lookup mechanism.

Why This Module Matters

Every SyncApp provision, every credential rotation, and every data source deletion goes through sync-app-authentication. Confusing it with sync-app-oauth is a common mistake. Getting this distinction right will save you hours of confusion when debugging provisioning or authentication failures.

Learning Goals

• Clearly distinguish sync-app-authentication from sync-app-oauth
• Understand sync-app-authentication's purpose: managing data source lifecycle
• Explain the authenticate method: validate credentials, lookup with cache
• List the operations exposed by sync-app-authentication: authenticate, delete, list, reset details, location custom content
• Understand how sync-app-support uses sync-app-authentication as a client

Lessons