appliance-test-setup

Provision and clean up Safeguard test objects for integration testing.

24|35|Updated Sep 14, 2017
One-click install
npx skills add https://github.com/OneIdentity/safeguard-ps --skill appliance-test-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: appliance-test-setup
Source: https://github.com/OneIdentity/safeguard-ps/tree/main/.agents/skills/appliance-test-setup
Command: npx skills add https://github.com/OneIdentity/safeguard-ps --skill appliance-test-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the risk and effort of manually creating and cleaning up interdependent test objects on a Safeguard appliance during integration testing.

Core Features & Use Cases

  • End-to-end test object provisioning: Creates a dedicated test admin, asset, asset account, A2A-related certificates and users, A2A registration, and credential retrieval in the correct dependency order.
  • Certificate and A2A setup for integration tests: Generates client certificates for A2A, installs trusted certificates, links certificate users by thumbprint, and registers A2A credential retrieval.
  • Deterministic cleanup: Removes A2A registrations and underlying objects in reverse dependency order to reduce leftovers and test flakiness.

Quick Start

Use appliance-test-setup to create and then clean up integration-test users, assets, accounts, certificates, and A2A registrations on a connected Safeguard appliance using a dedicated admin account.

Frequently Asked Questions about appliance-test-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Safeguard test object provisioning and cleanup for integration testing?

Automate Safeguard test object provisioning by orchestrating the full lifecycle of admin users, assets, and accounts, then execute deterministic reverse-dependency cleanup to remove all leftover resources. This provides repeatable setup and teardown for live appliance integration tests.

How do I set up A2A certificates and registration for Safeguard integration tests?

Set up A2A certificates for integration tests by generating client certificates, installing trusted certificates, linking certificate users by thumbprint, and registering A2A credential retrieval. This establishes the required certificate and A2A registration chain for testing.

What is the correct dependency order for creating Safeguard test assets and A2A users?

The correct dependency order for Safeguard test assets requires creating a dedicated test admin, an asset, an asset account, and then the related A2A certificates and users. You must supply correct platform and partition IDs to establish this chain.

Do I need an authenticated safeguard-ps session to provision test objects?

Yes, you need an authenticated safeguard-ps session to provision test objects on a live appliance. This active PowerShell module session provides the required authorization to execute resource creation and A2A registration commands.

Why does Safeguard test object cleanup fail or leave leftovers on the appliance?

Safeguard test object cleanup fails or leaves leftovers when teardown does not execute in reverse dependency order. Removing A2A registrations and underlying objects in the correct reverse sequence prevents leftover resources and reduces test flakiness.

Can I use appliance-test-setup for repeatable Safeguard resource provisioning?

Yes, appliance-test-setup targets scenarios needing repeatable provisioning of Safeguard resources. It creates and removes integration-test users, assets, accounts, certificates, and A2A registrations on a connected appliance using a dedicated admin account.