WeKraftDocs
DocsSettings & PlatformSecurity & Permissions

Security & Permissions

6 min read
Updated May 2026
WeKraft Team

WeKraft takes your data security seriously. This page covers how access control works, how your data is protected, and best practices for keeping your projects secure.

Project Visibility

Every project has a visibility setting that determines who can find and join it:

VisibilityWho can see itHow to join
PublicDiscoverable via search and the Discover tabAnyone can view the overview and submit a join request
PrivateHidden from search entirelyUsers can only join via a direct invite link shared by the owner or admin

You can change visibility at any time from Project Settings → General.

Important
Changing a project from Private to Public makes it discoverable immediately. Any user can then see the project overview and submit a join request.

Role-Based Access Control (RBAC)

WeKraft uses a four-tier role system. Every project member is assigned exactly one role, and roles are hierarchical — each includes all permissions of the roles below it.

Role Overview

RoleBadgeWho gets itSummary
Owner👑 CrownThe person who created the projectFull control over everything
Admin🛡 ShieldPromoted by the ownerCan manage members, sprints, and project settings
MemberDefault role for new joinersCan create tasks/issues (if enabled), comment, and log time
Viewer👁 EyeAssigned by owner/adminRead-only access to all project data

Detailed Permissions Matrix

ActionOwnerAdminMemberViewer
View all project data
Comment on tasks/issues
Create tasks✓*
Create issues✓*
Edit any task/issueOwn only
Log time
Create sprints
Start/complete sprint
Accept/reject join requests
Promote/demote roles
Remove a member
Edit project settings
Delete project
Set project deadline & alerts
Note
*Members can create tasks and issues only if the project owner has enabled "Members can create" in Project Settings → Configuration.

Authentication

WeKraft uses secure single sign-on (SSO) providers:

  • Version Control Provider — recommended for developers; also enables repository linking and commit tracking
  • Third-Party Identity Provider — quick sign-in for non-developers

We never store your passwords. Authentication is handled entirely by the provider, and WeKraft receives only the minimum profile information needed (name, email, avatar).

Editor Extension Authentication

The editor extension uses a secure one-time handshake token system:

  1. The extension opens your browser to the WeKraft web app
  2. You click "Grant Access to IDE" — a single-use token is generated (5-minute expiry)
  3. The token is exchanged for a permanent API key stored in the editor's encrypted secret storage
  4. The handshake token is deleted immediately after exchange — it cannot be reused
Tip
No manual API key copying is required. The entire flow is automated. See the Editor Extension guide for full setup details.

Data Security

Encryption

All data is encrypted at rest and in transit using industry-standard encryption protocols.

Real-Time Sync

WeKraft uses a real-time backend database infrastructure. All data changes sync instantly across all connected clients without page refreshes, with built-in data validation, access control, and transactional guarantees.

Repository Integration Access

When you connect a code repository, WeKraft only requests the minimum permissions required to:

  1. Read repository metadata — name, default branch, stars, forks, language breakdown
  2. Sync Issues — import issues into WeKraft for tracking
  3. Read commit metadata — link commits to tasks for traceability
  4. Fetch file tree — display the repository file structure in the File Explorer
Important
We do not store your source code on our servers. The File Explorer fetches repository tree data via the hosting provider API on demand and caches the structure temporarily for performance.

Data Privacy

DataVisibility
Email addressNever shared publicly — only visible to you
Profile info (name, avatar, bio, skills)Visible to teammates in shared projects
Social links (profiles, LinkedIn, Twitter, portfolio)Visible only when someone views your full profile
Tasks & IssuesVisible only to project members
Time logsVisible only to project members
AI Assistant conversationsScoped to the project; the agent only sees data within its active project

Best Practices

  1. Use the Viewer role for stakeholders who need to stay informed but aren't actively developing
  2. Limit Admin roles to 1–2 trusted team members to prevent accidental configuration changes
  3. Review Join Requests regularly in the Manage Team settings to ensure only authorized users have access
  4. Keep projects Private unless you intentionally want public discoverability
  5. Connect your repository account through the dashboard rather than personal access tokens for better security

Next Steps

Was this page helpful?