# sailpoint-oss/upload-saas-connector architecture

> Architecture diagram of the GitHub repository sailpoint-oss/upload-saas-connector, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sailpoint-oss/upload-saas-connector
- Repository: https://github.com/sailpoint-oss/upload-saas-connector

## Overview

##### Project type and purpose
- This is an open-source GitHub Action whose sole responsibility is to build and upload a SaaS connector to SailPoint Identity Security Cloud.
- It wraps Node.js and SailPoint CLI commands into a reusable workflow step.

##### File structure
- Top‐level files:
- README.md – documents usage and inputs
- action.yaml – GitHub Action metadata (defines inputs like node-version, cli-version, connector-alias, base-url, client-id, client-secret)
- No nested directories – this is a single-component action.

##### README for additional insights
- The Action supports optional overrides for Node.js version and SailPoint CLI version.
- It expects environment variables for the SailPoint base URL and credentials.
- It runs on the GitHub Actions runner and calls the Identity Security Cloud REST API to upload the built connector.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% GitHub Components
    subgraph "GitHub Actions" 
        direction TB
        Workflow["Workflow (.github/workflows)"] 
        Runner["GitHub Actions Runner"]
    end

    %% User Repository
    ConnectorCode["User's Connector Source Code"]:::general

    %% Action Component
    UploadAction["upload-saas-connector Action"]:::github

    %% Runtime Tools
    subgraph "Runtime Tools"
        direction TB
        NodeJS["Node.js Runtime"]:::runtime
        CLI["SailPoint CLI"]:::runtime
    end

    %% External Service
    ISCAPI["Identity Security Cloud API"]:::external

    %% Inputs
    Inputs["Inputs:<br/>• node-version<br/>• cli-version<br/>• connector-alias<br/>• base-url<br/>• client-id<br/>• client-secret"]:::general

    %% Flow
    Workflow -->|"trigger event"| Runner
    Runner -->|"checkout code"| ConnectorCode
    Runner -->|"loads action"| UploadAction
    UploadAction -->|"installs/configures"| NodeJS
    UploadAction -->|"installs/configures"| CLI
    UploadAction -->|"builds connector"| ConnectorCode
    UploadAction -->|"reads inputs & env vars"| Inputs
    UploadAction -->|"calls API with payload"| ISCAPI
    ISCAPI -->|"returns success/failure"| UploadAction
    UploadAction -->|"outputs logs"| Runner

    %% Click Events
    click UploadAction "https://github.com/sailpoint-oss/upload-saas-connector/blob/main/action.yaml"
    click Inputs "https://github.com/sailpoint-oss/upload-saas-connector/blob/main/README.md"

    %% Styles
    classDef github fill:#cce5ff,stroke:#004085,color:#004085;
    classDef runtime fill:#d4edda,stroke:#155724,color:#155724;
    classDef external fill:#fff3cd,stroke:#856404,color:#856404;
    classDef general fill:#e2e3e5,stroke:#d6d8db,color:#383d41;
```
