Skip to content

General Settings

General Settings allow administrators to configure various aspects of the NetOrca platform. These settings control integrations, user interface features, and system behavior. Here is the list of available general settings.

LDAP

Configure LDAP authentication integration for enterprise user management.

Configuration Fields:

Field Description
ENABLED Enable/disable LDAP authentication
SERVER_URI LDAP server connection string
BIND_DN Distinguished name for binding
BIND_PASSWORD Password for binding (encrypted)
USER_SEARCH_BASE_DN Base DN for user searches
GROUP_SEARCH_QUERY_BASE_DN Base DN for group searches

SMTP

Configure email server settings for sending system notifications.

Configuration Fields:

Field Description
ENABLED Enable/disable email functionality
EMAIL_HOST SMTP server hostname
EMAIL_PORT SMTP server port
EMAIL_HOST_USER Username for SMTP authentication
EMAIL_HOST_PASSWORD Password for SMTP authentication (encrypted)
EMAIL_USE_TLS Enable TLS encryption

Feedback

Configure the feedback system for collecting user input and suggestions.

Configuration Fields:

Field Description
ENABLED Enable/disable feedback system
feedback_link URL or link for feedback submission

Google OAuth

Configure Google OAuth integration for single sign-on authentication.

Configuration Fields:

Field Description
ENABLED Enable/disable Google OAuth
CLIENT_ID Google OAuth client ID (encrypted)
CLIENT_SECRET Google OAuth client secret (encrypted, write-only)

Currency

Set the default currency for displaying costs and billing information.

Configuration Fields:

Field Description
ENABLED Enable/disable currency
currency Currency code (choices: USD, EUR, GBP)

Charges Settings

Control visibility and access to charges and billing information.

Configuration Fields:

Field Description
ENABLED Enable/disable ChargesSettings
hide_for_serviceowners Hide charges from service owners
hide_for_consumers Hide charges from consumers
only_admins_can_see Only administrators can see charges

Submission Builder

Configure the submission builder feature for creating and managing submissions in GUI.

Configuration Fields:

Field Description
show_submission_builder Show submission builder in UI
enable_submit_functionality Enable submit functionality
default_allow_submit_submission_builder Default permission for submission building

Service Creator

Control service creation feature on GUI.

Configuration Fields:

Field Description
show_create_service_option Show service creation option in UI
allow_service_creation Allow users to create services
default_allow_service_creation Default permission for service creation

AI Integration

Configure AI-powered features and integrations within NetOrca.

Configuration Fields:

Field Description
show_ai_validator Show AI validator functionality
show_ai_processor Show AI processor functionality (NetOrca Pack)
show_ai_integration Auto-calculated field showing if any AI feature is enabled
generative_ui_catalog_schema Defines the allowed Generative UI component structure for AI Processor output

Generative UI Catalog Schema

The Generative UI Catalog Schema is used by NetOrca Pack when an AI Processor has Enable generative UI turned on. It defines the allowed component structure that the AI may return for rich GUI rendering.

A Generate Schema button is available to automatically generate the catalog schema based on the currently configured components in the codebase. After generating, administrators can fine-tune the schema — for example, limiting the variety of component types the AI is allowed to return, or restricting certain options such as available CSS styles.

This setting allows administrators to control which Generative UI response shapes are considered valid. Service Owners do not usually edit this setting during normal AI Processor creation; instead, they enable the feature on a processor and provide a suitable prompt. The platform setting defines the permitted response structure behind the scenes.

When the feature is enabled on an AI Processor:

  • the AI is expected to return JSON matching the Generative UI component schema
  • the frontend renders only supported component types
  • if the response is invalid or unsupported, NetOrca falls back to the standard response renderer

For a user-focused explanation of how this feature is enabled on an AI Processor, see AI Processors — Generative UI.

GUI Table Settings

Configure GUI table settings and filtering options.

Configuration Fields:

Field Description
ENABLED Enable/disable Auto-refresh
table_refresh_interval Auto-refresh interval in seconds
default_filter_states_for_consumers Default Change Instance state filters for consumers
default_filter_states_for_serviceowners Default Change Instance state filters for service owners

Global Banner

Display important announcements and messages to all users.

Configuration Fields:

Field Description
ENABLED Enable/disable global banner
message Banner message text

External API Settings

Configure rate limiting and access controls for external API endpoints.

Configuration Fields:

Field Description
healthcheck_rate_limit_per_minute Rate limit for healthcheck endpoints
healthcheck_response_rate_limit Response rate limit for healthcheck
webhook_rate_limit_per_minute Rate limit for webhook endpoints
webhook_response_rate_limit Response rate limit for webhooks

How to Configure General Settings

To configure general settings:

GET /v1/core/general_settings/ HTTP/1.1
Content-Type: application/json
Authorization: Token <YOUR_TOKEN>