Overview
The Red Hat OpenShift Integration allows Cywift to securely connect with OpenShift API servers to collect infrastructure, node, and workload-related data.
Before starting the integration, ensure the following
- Cluster administrator access to OpenShift
- API Server URL
- Service Account with appropriate Cluster Role permissions
- Network connectivity between Cywift and the API server
Step1: Create Service Account
Cywift uses a service account token for secure API communication.
- Create a service account in your OpenShift project.
- Assign the 'cluster-reader' ClusterRole to the service account.
- Retrieve the API token for the service account.
Step2: Navigate to Integrations in Cywift

- Log in to the Cywift Platform
- Go to Integration from the left menu
- Under Virtualization
- Select Red Hat OpenShift
- Click Connect
Step3: Add Individual Integration

RequiredFields:
- Number of Integration: Select Individual Integration
- Integration Type: Virtualization
- Collectors: Select a configured collector
- Integration System: Red Hat OpenShift
- Alias: Enter a friendly name
- Owner: Select integration owner
- Host Address: Enter API Server URL (e.g., https://api.cluster.domain:6443)
- Username: Enter the Service Account Name
- Password: Enter the Service Account Token
Step 4: Add Bulk Integration
Use this option to integrate multiple Red Hat OpenShift instance.

Steps:
• Select Bulk Integration
• Download Template
• Fill required account details
• Upload file
• Click Test Connection
Troubleshooting Tips
- Verify API credentials
- Confirm API service is enabled for the target environment
- Check network connectivity and port accessibility
- Ensure firewall rules allow access from the Cywift collector to the target host