@things-factory/auth-base 7.0.1-beta.18 → 7.0.1-beta.22

package/helps/config/password.ko.md

@@ -0,0 +1,65 @@
+# password
+
+패스워드 설정 규칙을 유연하게 정의하고 이러한 규칙을 기반으로 패스워드를 유효성 검사할 수 있습니다.
+
+패스워드 규칙은 대/소문자, 숫자, 특수문자 및 길이와 같은 다양한 요소들을 조절할 수 있어 보안 정책에 맞게 패스워드 규칙을 커스터마이징할 수 있습니다.
+
+- `lowerCase` (기본값: `true`):
+
+  - 소문자를 포함하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 최소한 하나의 소문자를 포함해야 합니다.
+
+- `upperCase` (기본값: `true`):
+
+  - 대문자를 포함하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 최소한 하나의 대문자를 포함해야 합니다.
+
+- `digit` (기본값: `true`):
+
+  - 숫자를 포함하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 최소한 하나의 숫자를 포함해야 합니다.
+
+- `specialCharacter` (기본값: `true`):
+
+  - 특수 문자를 포함하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 최소한 하나의 특수 문자(!@#$%^&\*())를 포함해야 합니다.
+
+- `allowRepeat` (기본값: `false`):
+
+  - 문자 반복을 허용하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드에 문자가 두 번 이상 연속으로 반복되지 않아야 합니다.
+
+- `useTightPattern` (기본값: `true`):
+
+  - 엄격한 패스워드 패턴을 사용할지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 길이와 각 요소 (소문자, 대문자, 숫자, 특수 문자)에 대한 요구 사항을 엄격하게 따라야 합니다.
+
+- `useLoosePattern` (기본값: `false`):
+
+  - 느슨한 패스워드 패턴을 사용할지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드의 길이만 엄격하게 체크하고 다른 요소에 대한 요구 사항은 무시합니다.
+
+- `tightCharacterLength` (기본값: `8`):
+
+  - 엄격한 패스워드 패턴을 사용할 경우, 패스워드의 최소 길이를 나타냅니다.
+
+- `looseCharacterLength` (기본값: `15`):
+
+  - 느슨한 패스워드 패턴을 사용할 경우, 패스워드의 최소 길이를 나타냅니다.
+
+- `defaultPassword` (기본값: false):
+  - 관리자가 사용자를 등록하는 경우, 새로운 사용자에게 설정되는 기본 패스워드이다.
+  - 이 값이 false 이면, 관리자가 사용자를 등록하는 기능은 사용할 수 없다.
+
+## default
+
+```
+module.exports = {
+  password: {
+    lowerCase: true,
+    upperCase: false,
+    digit: true,
+    specialCharacter: true,
+    allowRepeat: true,
+    useTightPattern: true,
+    useLoosePattern: false,
+    tightCharacterLength: 8,
+    looseCharacterLength: 15,
+    history: 2,
+    defaultPassword: false
+  },
+}
+```

package/helps/config/password.md

@@ -1,48 +1,20 @@
 # password
 
-패스워드 설정 규칙을 유연하게 정의하고 이러한 규칙을 기반으로 패스워드를 유효성 검사할 수 있습니다.
+can flexibly define password setting rules and validate passwords based on these rules.
 
-패스워드 규칙은 대/소문자, 숫자, 특수문자 및 길이와 같은 다양한 요소들을 조절할 수 있어 보안 정책에 맞게 패스워드 규칙을 커스터마이징할 수 있습니다.
+password rules can adjust various elements such as case sensitivity, numbers, special characters, and length to customize password rules according to security policies.
 
-- `lowerCase` (기본값: `true`):
+- `lowerCase` (default: `true`):
 
-  - 소문자를 포함하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 최소한 하나의 소문자를 포함해야 합니다.
+  - a boolean value indicating whether to include lowercase letters. if set, the password must contain at least one lowercase letter.
 
-- `upperCase` (기본값: `true`):
+- `upperCase` (default: `true`):
 
-  - 대문자를 포함하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 최소한 하나의 대문자를 포함해야 합니다.
+  - a boolean value indicating whether to include uppercase letters. if set, the password must contain at least one uppercase letter.
 
-- `digit` (기본값: `true`):
+- `digit` (default: `true`):
 
-  - 숫자를 포함하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 최소한 하나의 숫자를 포함해야 합니다.
-
-- `specialCharacter` (기본값: `true`):
-
-  - 특수 문자를 포함하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 최소한 하나의 특수 문자(!@#$%^&\*())를 포함해야 합니다.
-
-- `allowRepeat` (기본값: `false`):
-
-  - 문자 반복을 허용하는지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드에 문자가 두 번 이상 연속으로 반복되지 않아야 합니다.
-
-- `useTightPattern` (기본값: `true`):
-
-  - 엄격한 패스워드 패턴을 사용할지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드는 길이와 각 요소 (소문자, 대문자, 숫자, 특수 문자)에 대한 요구 사항을 엄격하게 따라야 합니다.
-
-- `useLoosePattern` (기본값: `false`):
-
-  - 느슨한 패스워드 패턴을 사용할지 여부를 나타내는 부울 값입니다. 설정된 경우, 패스워드의 길이만 엄격하게 체크하고 다른 요소에 대한 요구 사항은 무시합니다.
-
-- `tightCharacterLength` (기본값: `8`):
-
-  - 엄격한 패스워드 패턴을 사용할 경우, 패스워드의 최소 길이를 나타냅니다.
-
-- `looseCharacterLength` (기본값: `15`):
-
-  - 느슨한 패스워드 패턴을 사용할 경우, 패스워드의 최소 길이를 나타냅니다.
-
-- `defaultPassword` (기본값: false):
-  - 관리자가 사용자를 등록하는 경우, 새로운 사용자에게 설정되는 기본 패스워드이다.
-  - 이 값이 false 이면, 관리자가 사용자를 등록하는 기능은 사용할 수 없다.
+  - a boolean value indicating whether
 
 ## default
 

package/helps/config/password.ms.md

@@ -0,0 +1,65 @@
+# password
+
+boleh menentukan peraturan tetapan kata laluan dengan fleksibel dan mengesahkan kata laluan berdasarkan peraturan ini.
+
+peraturan kata laluan boleh melaraskan pelbagai elemen seperti huruf besar/kecil, nombor, aksara khas, dan panjang untuk menyesuaikan peraturan kata laluan dengan dasar keselamatan.
+
+- `lowerCase` (nilai lalai: `true`):
+
+  - nilai boolean yang menunjukkan sama ada mengandungi huruf kecil. Jika ditetapkan, kata laluan mesti mengandungi sekurang-kurangnya satu huruf kecil.
+
+- `upperCase` (nilai lalai: `true`):
+
+  - nilai boolean yang menunjukkan sama ada mengandungi huruf besar. Jika ditetapkan, kata laluan mesti mengandungi sekurang-kurangnya satu huruf besar.
+
+- `digit` (nilai lalai: `true`):
+
+  - nilai boolean yang menunjukkan sama ada mengandungi nombor. Jika ditetapkan, kata laluan mesti mengandungi sekurang-kurangnya satu nombor.
+
+- `specialCharacter` (nilai lalai: `true`):
+
+  - nilai boolean yang menunjukkan sama ada mengandungi aksara khas. Jika ditetapkan, kata laluan mesti mengandungi sekurang-kurangnya satu aksara khas (!@#$%^&\*()).
+
+- `allowRepeat` (nilai lalai: `false`):
+
+  - nilai boolean yang menunjukkan sama ada membenarkan pengulangan aksara. Jika ditetapkan, kata laluan tidak boleh mengandungi aksara yang diulang lebih daripada dua kali berturut-turut.
+
+- `useTightPattern` (nilai lalai: `true`):
+
+  - nilai boolean yang menunjukkan sama ada menggunakan pola kata laluan yang ketat. Jika ditetapkan, kata laluan mesti memenuhi keperluan panjang dan setiap elemen (huruf kecil, huruf besar, nombor, aksara khas) dengan ketat.
+
+- `useLoosePattern` (nilai lalai: `false`):
+
+  - nilai boolean yang menunjukkan sama ada menggunakan pola kata laluan yang longgar. Jika ditetapkan, hanya panjang kata laluan diperiksa dengan ketat dan keperluan elemen lain diabaikan.
+
+- `tightCharacterLength` (nilai lalai: `8`):
+
+  - panjang minimum kata laluan apabila menggunakan pola kata laluan yang ketat.
+
+- `looseCharacterLength` (nilai lalai: `15`):
+
+  - panjang minimum kata laluan apabila menggunakan pola kata laluan yang longgar.
+
+- `defaultPassword` (nilai lalai: false):
+  - kata laluan lalai yang ditetapkan kepada pengguna baru apabila pentadbir mendaftarkan pengguna.
+  - jika nilai ini adalah false, pentadbir tidak boleh menggunakan fungsi pendaftaran pengguna.
+
+## default
+
+```
+module.exports = {
+  password: {
+    lowerCase: true,
+    upperCase: false,
+    digit: true,
+    specialCharacter: true,
+    allowRepeat: true,
+    useTightPattern: true,
+    useLoosePattern: false,
+    tightCharacterLength: 8,
+    looseCharacterLength: 15,
+    history: 2,
+    defaultPassword: false
+  },
+}
+```

package/helps/config/password.zh.md

@@ -0,0 +1,65 @@
+# password
+
+可以灵活定义密码设置规则，并基于这些规则验证密码的有效性。
+
+密码规则可以调整大小写字母、数字、特殊字符和长度等各种元素，以便根据安全策略自定义密码规则。
+
+- `lowerCase` (默认值: `true`):
+
+  - 布尔值，指示是否包含小写字母。如果设置，密码必须至少包含一个小写字母。
+
+- `upperCase` (默认值: `true`):
+
+  - 布尔值，指示是否包含大写字母。如果设置，密码必须至少包含一个大写字母。
+
+- `digit` (默认值: `true`):
+
+  - 布尔值，指示是否包含数字。如果设置，密码必须至少包含一个数字。
+
+- `specialCharacter` (默认值: `true`):
+
+  - 布尔值，指示是否包含特殊字符。如果设置，密码必须至少包含一个特殊字符(!@#$%^&\*())。
+
+- `allowRepeat` (默认值: `false`):
+
+  - 布尔值，指示是否允许字符重复。如果设置，密码中字符不得连续重复两次以上。
+
+- `useTightPattern` (默认值: `true`):
+
+  - 布尔值，指示是否使用严格的密码模式。如果设置，密码必须严格遵循长度和各个元素（小写字母、大写字母、数字、特殊字符）的要求。
+
+- `useLoosePattern` (默认值: `false`):
+
+  - 布尔值，指示是否使用宽松的密码模式。如果设置，密码只严格检查长度，忽略其他元素的要求。
+
+- `tightCharacterLength` (默认值: `8`):
+
+  - 使用严格密码模式时，密码的最小长度。
+
+- `looseCharacterLength` (默认值: `15`):
+
+  - 使用宽松密码模式时，密码的最小长度。
+
+- `defaultPassword` (默认值: false):
+  - 管理员注册用户时，设置给新用户的默认密码。
+  - 如果此值为false，则管理员无法使用用户注册功能。
+
+## default
+
+```
+module.exports = {
+  password: {
+    lowerCase: true,
+    upperCase: false,
+    digit: true,
+    specialCharacter: true,
+    allowRepeat: true,
+    useTightPattern: true,
+    useLoosePattern: false,
+    tightCharacterLength: 8,
+    looseCharacterLength: 15,
+    history: 2,
+    defaultPassword: false
+  },
+}
+```

package/helps/config/publicHomeRoute.ja.md

@@ -0,0 +1,14 @@
+# publicHomeRoute
+
+ログインしていないユーザーがアプリケーションURLに初めてアクセスしたときに表示されるページのパスを指定します。
+
+通常は '/public/home' パスにルーティングされ、イントロ画面が表示されます。
+ログインページに直接移動したい場合は、この設定を '/auth/signin' に設定します。
+
+## default
+
+```
+module.exports = {
+  publicHomeRoute: '/public/home',
+}
+```

package/helps/config/publicHomeRoute.ko.md

@@ -0,0 +1,14 @@
+# publicHomeRoute
+
+로그인되지 않은 사용자가 어플리케이션 URL에 처음 접근했을 때, 보여지게 될 페이지의 path를 지정한다.
+
+보통 '/public/home' 패스로 라우팅되어 인트로 화면을 볼 수 있다.
+만약, 로그인 페이지로 바로 이동하고 싶다면, 이 설정을 '/auth/signin' 으로 설정하면 된다.
+
+## default
+
+```
+module.exports = {
+  publicHomeRoute: '/public/home',
+}
+```

package/helps/config/publicHomeRoute.md

@@ -1,9 +1,9 @@
 # publicHomeRoute
 
-로그인되지 않은 사용자가 어플리케이션 URL에 처음 접근했을 때, 보여지게 될 페이지의 path를 지정한다.
+specifies the path of the page to be displayed when a user who is not logged in first accesses the application URL.
 
-보통 '/public/home' 패스로 라우팅되어 인트로 화면을 볼 수 있다.
-만약, 로그인 페이지로 바로 이동하고 싶다면, 이 설정을 '/auth/signin' 으로 설정하면 된다.
+usually routed to the '/public/home' path to display the intro screen.
+if you want to go directly to the login page, set this to '/auth/signin'.
 
 ## default
 

package/helps/config/publicHomeRoute.ms.md

@@ -0,0 +1,14 @@
+# publicHomeRoute
+
+menentukan laluan halaman yang akan dipaparkan apabila pengguna yang belum log masuk mengakses URL aplikasi buat kali pertama.
+
+biasanya akan dilalukan ke laluan '/public/home' untuk memaparkan skrin pengenalan.
+jika ingin terus ke halaman log masuk, tetapkan ini ke '/auth/signin'.
+
+## default
+
+```
+module.exports = {
+  publicHomeRoute: '/public/home',
+}
+```

package/helps/config/publicHomeRoute.zh.md

@@ -0,0 +1,14 @@
+# publicHomeRoute
+
+指定未登录用户首次访问应用程序URL时显示的页面路径。
+
+通常会路由到 '/public/home' 路径，以显示介绍页面。
+如果希望直接跳转到登录页面，可以将此设置为 '/auth/signin'。
+
+## default
+
+```
+module.exports = {
+  publicHomeRoute: '/public/home',
+}
+```

package/helps/config/session.ja.md

@@ -0,0 +1,45 @@
+# session
+
+セッション有効期間に関する設定を行うことができます。
+
+- expirySeconds: セッション有効時間（秒単位）
+
+  - この値は、ユーザーセッションが非アクティブの後に何秒で期限切れになるかを定義します。
+  - これを1800に設定すると、30分の非アクティブ後にセッションが期限切れになります。
+
+- expiryPolicy: セッション有効期限ポリシー
+
+  - この設定は、セッションのタイムアウトをどのように管理するかを決定します。
+  - オプション：
+
+    - 'rolling' - セッションのタイムアウトはユーザーのアクティビティに基づいて延長されます。
+      各新しいリクエストは、タイマーを指定されたタイムアウト期間にリセットします。
+    - 'fixed' - セッションのタイムアウトは固定されて
+
+## default
+
+```
+module.exports = {
+  session: {
+    /*
+      Session Expiry Time in Seconds
+      This value defines the duration in seconds after which a user session will expire due to inactivity.
+      Setting this to 1800 means the session will expire after 30 minutes of inactivity.
+    */
+    expirySeconds: 60 * 60 * 24 * 7,
+    /*
+      Session Expiry Policy
+      This setting determines how the session timeout is managed.
+      Options:
+        'rolling' - The session timeout is extended based on user activity.
+                    Each new request resets the timer to the specified timeout duration.
+        'fixed'   - The session timeout is fixed and based on the initial login time.
+                    The session will expire after the specified duration, regardless of user activity.
+
+      Example:
+      expiryPolicy: 'rolling' or 'fixed'
+    */
+    expiryPolicy: 'fixed'
+  },
+}
+```

package/helps/config/session.ko.md

@@ -0,0 +1,49 @@
+# session
+
+세션 유효기간과 관련한 설정을 할 수 있다.
+
+- expirySeconds: Session Expiry Time in Seconds
+
+  - This value defines the duration in seconds after which a user session will expire due to inactivity.
+  - Setting this to 1800 means the session will expire after 30 minutes of inactivity.
+
+- expiryPolicy: Session Expiry Policy
+
+  - This setting determines how the session timeout is managed.
+  - Options:
+
+    - 'rolling' - The session timeout is extended based on user activity.
+      Each new request resets the timer to the specified timeout duration.
+    - 'fixed' - The session timeout is fixed and based on the initial login time.
+      The session will expire after the specified duration, regardless of user activity.
+
+          Example:
+          expiryPolicy: 'rolling' or 'fixed'
+
+## default
+
+```
+module.exports = {
+  session: {
+    /*
+      Session Expiry Time in Seconds
+      This value defines the duration in seconds after which a user session will expire due to inactivity.
+      Setting this to 1800 means the session will expire after 30 minutes of inactivity.
+    */
+    expirySeconds: 60 * 60 * 24 * 7,
+    /*
+      Session Expiry Policy
+      This setting determines how the session timeout is managed.
+      Options:
+        'rolling' - The session timeout is extended based on user activity.
+                    Each new request resets the timer to the specified timeout duration.
+        'fixed'   - The session timeout is fixed and based on the initial login time.
+                    The session will expire after the specified duration, regardless of user activity.
+
+      Example:
+      expiryPolicy: 'rolling' or 'fixed'
+    */
+    expiryPolicy: 'fixed'
+  },
+}
+```

package/helps/config/session.md

@@ -1,23 +1,23 @@
 # session
 
-세션 유효기간과 관련한 설정을 할 수 있다.
+you can set the session expiration settings.
 
 - expirySeconds: Session Expiry Time in Seconds
 
-  - This value defines the duration in seconds after which a user session will expire due to inactivity.
-  - Setting this to 1800 means the session will expire after 30 minutes of inactivity.
+  - this value defines the duration in seconds after which a user session will expire due to inactivity.
+  - setting this to 1800 means the session will expire after 30 minutes of inactivity.
 
 - expiryPolicy: Session Expiry Policy
 
-  - This setting determines how the session timeout is managed.
-  - Options:
+  - this setting determines how the session timeout is managed.
+  - options:
 
-    - 'rolling' - The session timeout is extended based on user activity.
-      Each new request resets the timer to the specified timeout duration.
-    - 'fixed' - The session timeout is fixed and based on the initial login time.
-      The session will expire after the specified duration, regardless of user activity.
+    - 'rolling' - the session timeout is extended based on user activity.
+      each new request resets the timer to the specified timeout duration.
+    - 'fixed' - the session timeout is fixed and based on the initial login time.
+      the session will expire after the specified duration, regardless of user activity.
 
-          Example:
+          example:
           expiryPolicy: 'rolling' or 'fixed'
 
 ## default

package/helps/config/session.ms.md

@@ -0,0 +1,46 @@
+# session
+
+boleh menetapkan tetapan berkaitan tempoh sah sesi.
+
+- expirySeconds: Masa Tamat Sesi dalam Detik
+
+  - nilai ini menentukan tempoh dalam detik selepas mana sesi pengguna akan tamat akibat ketidakaktifan.
+  - menetapkan ini kepada 1800 bermaksud sesi akan tamat selepas 30 minit ketidakaktifan.
+
+- expiryPolicy: Polisi Tamat Sesi
+
+  - tetapan ini menentukan bagaimana masa tamat sesi diuruskan.
+  - pilihan:
+
+    - 'rolling' - masa tamat sesi dilanjutkan berdasarkan aktiviti pengguna.
+      setiap permintaan baru menetapkan semula pemasa kepada tempoh tamat yang ditentukan.
+    - 'fixed' - masa tamat sesi adalah tetap dan berdasarkan masa log masuk awal.
+      sesi akan tamat selepas tempoh yang dit
+
+## default
+
+```
+module.exports = {
+  session: {
+    /*
+      Session Expiry Time in Seconds
+      This value defines the duration in seconds after which a user session will expire due to inactivity.
+      Setting this to 1800 means the session will expire after 30 minutes of inactivity.
+    */
+    expirySeconds: 60 * 60 * 24 * 7,
+    /*
+      Session Expiry Policy
+      This setting determines how the session timeout is managed.
+      Options:
+        'rolling' - The session timeout is extended based on user activity.
+                    Each new request resets the timer to the specified timeout duration.
+        'fixed'   - The session timeout is fixed and based on the initial login time.
+                    The session will expire after the specified duration, regardless of user activity.
+
+      Example:
+      expiryPolicy: 'rolling' or 'fixed'
+    */
+    expiryPolicy: 'fixed'
+  },
+}
+```

package/helps/config/session.zh.md

@@ -0,0 +1,49 @@
+# session
+
+可以设置与会话有效期相关的设置。
+
+- expirySeconds: Session Expiry Time in Seconds
+
+  - 此值定义由于不活动，用户会话将在多少秒后过期。
+  - 将此值设置为1800意味着会话将在30分钟不活动后过期。
+
+- expiryPolicy: Session Expiry Policy
+
+  - 此设置确定如何管理会话超时。
+  - 选项：
+
+    - 'rolling' - 会话超时基于用户活动延长。
+      每个新请求将计时器重置为指定的超时持续时间。
+    - 'fixed' - 会话超时是固定的，基于初始登录时间。
+      无论用户活动如何，会话将在指定的持续时间后过期。
+
+          例子:
+          expiryPolicy: 'rolling' or 'fixed'
+
+## default
+
+```
+module.exports = {
+  session: {
+    /*
+      Session Expiry Time in Seconds
+      This value defines the duration in seconds after which a user session will expire due to inactivity.
+      Setting this to 1800 means the session will expire after 30 minutes of inactivity.
+    */
+    expirySeconds: 60 * 60 * 24 * 7,
+    /*
+      Session Expiry Policy
+      This setting determines how the session timeout is managed.
+      Options:
+        'rolling' - The session timeout is extended based on user activity.
+                    Each new request resets the timer to the specified timeout duration.
+        'fixed'   - The session timeout is fixed and based on the initial login time.
+                    The session will expire after the specified duration, regardless of user activity.
+
+      Example:
+      expiryPolicy: 'rolling' or 'fixed'
+    */
+    expiryPolicy: 'fixed'
+  },
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/auth-base",
-  "version": "7.0.1-beta.18",
+  "version": "7.0.1-beta.22",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -30,9 +30,9 @@
     "migration:create": "node ../../node_modules/typeorm/cli.js migration:create -d ./server/migrations"
   },
   "dependencies": {
-    "@things-factory/email-base": "^7.0.1-beta.18",
+    "@things-factory/email-base": "^7.0.1-beta.22",
     "@things-factory/env": "^7.0.1-beta.18",
-    "@things-factory/shell": "^7.0.1-beta.18",
+    "@things-factory/shell": "^7.0.1-beta.22",
     "@things-factory/utils": "^7.0.1-beta.10",
     "@types/webappsec-credential-management": "^0.6.8",
     "jsonwebtoken": "^9.0.0",
@@ -45,5 +45,5 @@
     "passport-local": "^1.0.0",
     "popsicle-cookie-jar": "^1.0.0"
   },
-  "gitHead": "44f0df6a133577bad8d184a529796c69249a8296"
+  "gitHead": "60c6bc4d55359465636a549687fc3e3f03d44a18"
 }