use proto::auth as proto; use tonic::Status; #[derive(Debug, thiserror::Error)] pub enum KenAuthError { #[error("kenoauth is unavailable: {0}")] Unavailable(String), #[error("kenoauth rejected the request: {0}")] Rejected(String), #[error("kenoauth could not find the requested object")] NotFound, #[error("kenoauth rejected the credential")] Unauthenticated, #[error("kenoauth configuration is invalid: {0}")] Config(String), #[error("kenoauth request failed: {0}")] Internal(String), } impl KenAuthError { pub fn from_status(status: Status) -> Self { match status.code() { tonic::Code::Unavailable | tonic::Code::DeadlineExceeded => { Self::Unavailable(status.message().to_string()) } tonic::Code::Unauthenticated => Self::Unauthenticated, tonic::Code::NotFound => Self::NotFound, tonic::Code::PermissionDenied | tonic::Code::InvalidArgument | tonic::Code::FailedPrecondition | tonic::Code::AlreadyExists | tonic::Code::ResourceExhausted | tonic::Code::Aborted => Self::Rejected(status.message().to_string()), _ => Self::Internal(status.message().to_string()), } } pub fn is_not_found(&self) -> bool { matches!(self, Self::NotFound) } pub fn is_unauthenticated(&self) -> bool { matches!(self, Self::Unauthenticated) } } #[async_trait::async_trait] pub trait AuthApi: Send + Sync { async fn check_health(&self) -> Result<(), KenAuthError>; async fn change_password( &self, user_id: i64, old_password_hash: &str, new_password_hash: &str, keep_session_id: &str, client_ip: &str, ) -> Result; async fn get_mfa_status( &self, user_id: i64, ) -> Result; async fn configure_totp( &self, user_id: i64, name: &str, client_ip: &str, ) -> Result; async fn enable_totp( &self, user_id: i64, code: &str, password_hash: &str, client_ip: &str, ) -> Result; async fn disable_totp( &self, user_id: i64, code: &str, client_ip: &str, ) -> Result; async fn regenerate_recovery_codes( &self, user_id: i64, password_hash: &str, client_ip: &str, ) -> Result; async fn list_user_ssh_keys( &self, user_id: i64, include_revoked: bool, page: proto::common::v1::PageRequest, ) -> Result; async fn add_ssh_key( &self, user_id: i64, name: &str, public_key: &str, description: &str, client_ip: &str, ) -> Result; async fn revoke_ssh_key( &self, user_id: i64, key_id: &str, reason: &str, bump_security_version: bool, ) -> Result; async fn list_user_sessions( &self, user_id: i64, include_revoked: bool, include_expired: bool, page: proto::common::v1::PageRequest, ) -> Result; async fn revoke_user_sessions( &self, user_id: i64, except_session_id: &str, reason: &str, bump_security_version: bool, ) -> Result; async fn get_session( &self, user_id: i64, version: i32, session_id: &str, ) -> Result; async fn delete_account(&self, user_id: i64, reason: &str) -> Result<(), KenAuthError>; async fn cancel_account_deletion(&self, user_id: i64) -> Result<(), KenAuthError>; async fn purge_account(&self, user_id: i64) -> Result<(), KenAuthError>; async fn batch_get_authority_users( &self, user_ids: Vec, ) -> Result, KenAuthError>; async fn get_user_status( &self, user_id: i64, ) -> Result; async fn get_user_public_by_ref( &self, key: proto::common::v1::user_ref::Key, ) -> Result; async fn get_authority_user( &self, user_id: i64, ) -> Result; async fn update_authority_user( &self, user_id: i64, username: Option, displayname: Option, clear_displayname: bool, public_show_email: Option, version: i32, ) -> Result; async fn batch_get_user_public( &self, user_ids: Vec, ) -> Result, KenAuthError>; async fn get_user_public( &self, user_id: i64, ) -> Result; async fn revoke_session( &self, user_id: i64, session_id: &str, reason: &str, ) -> Result<(), KenAuthError>; async fn lookup_ssh_key( &self, public_key: &str, ) -> Result, KenAuthError>; async fn ensure_bot_user( &self, username: &str, displayname: &str, system: bool, ) -> Result; async fn ensure_bot_member( &self, organization_id: &str, user_id: i64, role_keys: Vec, role_ids: Vec, ) -> Result; async fn get_organization( &self, actor_user_id: i64, organization_id: &str, slug: &str, ) -> Result; async fn get_member( &self, actor_user_id: i64, organization_id: &str, user_id: i64, ) -> Result, KenAuthError>; async fn list_members( &self, actor_user_id: i64, organization_id: &str, include_inactive: bool, include_banned: bool, page: proto::common::v1::PageRequest, ) -> Result; async fn list_organizations( &self, actor_user_id: i64, user_id: i64, include_archived: bool, page: proto::common::v1::PageRequest, ) -> Result; async fn list_public_organizations( &self, query: &str, page: proto::common::v1::PageRequest, ) -> Result; async fn check_permissions( &self, actor_user_id: i64, organization_id: &str, user_id: i64, permissions: Vec, ) -> Result; async fn create_organization( &self, actor_user_id: i64, slug: &str, name: &str, description: &str, avatar_url: &str, join_policy: Option, allow_join: Option, require_email_verified: Option, require_mfa: Option, welcome_message: Option, member_must_enable_2fa: Option, allow_invite: Option, allow_join_level: Option, ) -> Result; async fn update_organization( &self, actor_user_id: i64, organization_id: &str, name: Option, description: Option, avatar_url: Option, expected_version: i32, join_policy: Option, allow_join: Option, require_email_verified: Option, require_mfa: Option, welcome_message: Option, member_must_enable_2fa: Option, allow_invite: Option, allow_join_level: Option, ) -> Result; async fn archive_organization( &self, actor_user_id: i64, organization_id: &str, reason: &str, ) -> Result<(), KenAuthError>; async fn restore_organization( &self, actor_user_id: i64, organization_id: &str, ) -> Result<(), KenAuthError>; async fn delete_organization( &self, actor_user_id: i64, organization_id: &str, force: bool, reason: &str, ) -> Result<(), KenAuthError>; async fn add_member( &self, actor_user_id: i64, organization_id: &str, user_id: i64, role: i32, role_keys: Vec, ) -> Result<(proto::v1::OrganizationMemberInfo, bool), KenAuthError>; async fn remove_member( &self, actor_user_id: i64, organization_id: &str, user_id: i64, reason: &str, ) -> Result; async fn leave_organization( &self, actor_user_id: i64, organization_id: &str, ) -> Result; async fn update_member( &self, actor_user_id: i64, organization_id: &str, user_id: i64, alias_name: Option>, alias_avatar_url: Option>, message_notifications: Option, muted: Option, mute_until: Option>, mobile_push: Option, suppress_everyone: Option, suppress_roles: Option, hide_muted_channels: Option, ) -> Result; async fn ban_member( &self, actor_user_id: i64, organization_id: &str, user_id: i64, reason: &str, ) -> Result; async fn unban_member( &self, actor_user_id: i64, organization_id: &str, user_id: i64, ) -> Result; async fn update_ban( &self, actor_user_id: i64, organization_id: &str, user_id: i64, reason: Option>, expires_at: Option>, allow_speak: Option, allow_push_repo: Option, allow_comment_any: Option, ) -> Result; async fn create_role( &self, actor_user_id: i64, organization_id: &str, key: &str, name: &str, description: &str, rank: i32, self_assignable: bool, permissions: Vec, ) -> Result; async fn update_role( &self, actor_user_id: i64, organization_id: &str, role_id: &str, name: Option, description: Option, rank: Option, self_assignable: Option, expected_version: i32, ) -> Result; async fn set_role_permissions( &self, actor_user_id: i64, organization_id: &str, role_id: &str, permissions: Vec, ) -> Result; async fn delete_role( &self, actor_user_id: i64, organization_id: &str, role_id: &str, ) -> Result; async fn assign_role( &self, actor_user_id: i64, organization_id: &str, user_id: i64, role_id: &str, ) -> Result; async fn unassign_role( &self, actor_user_id: i64, organization_id: &str, user_id: i64, role_id: &str, ) -> Result; async fn create_invite( &self, actor_user_id: i64, organization_id: &str, method: i32, max_uses: i32, expires_at: Option, role_ids: Vec, target_user_id: i64, email: &str, ) -> Result<(proto::v1::OrganizationInviteInfo, String), KenAuthError>; async fn revoke_invite( &self, actor_user_id: i64, organization_id: &str, invite_id: &str, ) -> Result; async fn redeem_invite( &self, actor_user_id: i64, token: &str, ) -> Result; async fn create_join_rule( &self, actor_user_id: i64, organization_id: &str, role_id: &str, trigger: &str, matcher: &str, enabled: bool, ) -> Result; async fn update_join_rule( &self, actor_user_id: i64, organization_id: &str, rule_id: &str, role_id: Option, trigger: Option, matcher: Option, enabled: Option, ) -> Result; async fn delete_join_rule( &self, actor_user_id: i64, organization_id: &str, rule_id: &str, ) -> Result; async fn create_join_request( &self, actor_user_id: i64, organization_id: &str, note: &str, ) -> Result; async fn withdraw_join_request( &self, actor_user_id: i64, organization_id: &str, request_id: &str, ) -> Result; async fn approve_join_request( &self, actor_user_id: i64, organization_id: &str, request_id: &str, ) -> Result< ( proto::v1::JoinRequestInfo, Option, ), KenAuthError, >; async fn reject_join_request( &self, actor_user_id: i64, organization_id: &str, request_id: &str, note: &str, ) -> Result; }