Documentation
Learn how to use Krosyn to connect your applications.
Organization
Manage your organization settings, members, and security policies.
What is an Organization?
An organization is the top-level entity in Krosyn. It groups together connectors, endpoints, events, secrets, members, and billing. All data is scoped to the organization, so members of one organization cannot see or access data from another.
When you first sign up, you are prompted to create an organization or join one via an invitation. A user can belong to multiple organizations and switch between them.
Organization Settings
Owners and Admins can manage the following settings from the Settings > Organization page:
- Name: The display name of the organization
- Slug: A URL-friendly identifier used in your organization's login URL
- Contact email: Used for billing and notification purposes
Member Management
Manage team members from Settings > Members. See the Users & Roles page for details on inviting members, role permissions, and managing access.
Security Settings
Owners and Admins can configure organization-wide security policies:
- Require Two-Factor Authentication: When enabled, all members must set up 2FA within a configurable grace period. Members who do not comply within the grace period lose access until they enable 2FA.
- Grace Period: The number of days members have to enable 2FA after enforcement is turned on.
Switching Organizations
If you belong to multiple organizations, you can switch between them using the organization switcher in the sidebar. Switching changes the data context, so you will see the connectors, events, and settings for the selected organization.
Appearance
Customize the application theme from Settings > Appearance. Available options:
- Light, dark, or system theme (follows your OS preference)
- High contrast mode for WCAG AAA compliance
- Reduced motion to disable animations
Appearance is a personal preference and does not affect other organization members.
Single Sign-On (SSO)
Organizations on the Business plan can configure social login providers so members can sign in with their existing accounts instead of a password. Each organization manages its own OAuth credentials independently.
Supported Providers
Krosyn supports the following social login providers:
- Microsoft
- GitHub
- Apple
Setting Up a Provider
Owners and Admins can configure providers from Settings > Single Sign-On:
- Click Add Provider and select the provider you want to configure
- Enter the Client ID and Client Secret from the provider's developer console
- Copy the Redirect URL shown in Krosyn and add it to the provider's allowed redirect URIs
- Enable the provider when ready
Credentials are encrypted at rest. You can enable, disable, or remove providers at any time.
How Social Login Works
Once a provider is enabled, the Login and Register pages for your organization automatically show the corresponding social login buttons. Your organization's login page is accessed via a URL with the ?customer=your-org-slug parameter.
- First-time login: If no account exists for the social email, a new user is automatically created and added to the organization.
- Existing account: If an account with the same email already exists, the user is prompted to log in with their password first, then link the social account from Settings > Connected Accounts.
- 2FA integration: Social login respects the organization's two-factor authentication settings. If 2FA is enforced, users who sign in via social login are still required to complete 2FA.
Account Linking
Users can link or unlink social accounts from their personal settings page. A user can link multiple social providers to the same account, allowing them to sign in with any of the linked providers.
Rate Limiting
OAuth authentication attempts are rate-limited to 10 per minute to prevent abuse.
Data Isolation
All data in Krosyn is fully isolated per organization:
- Connectors, endpoints, and events belong to the organization, not individual users
- Secrets are scoped to the organization and only accessible by its connectors
- Dashboard statistics and audit logs are per-organization
- Billing and subscription limits apply per organization