認証機構¶
AuthType（2.4 より固定）¶
役割
認証の種類を指定する。（Apache 本体が定義）
構文
AuthType teamfile 2.4以降
AuthType [ Basic | Digest ] 2.3まで
デフォルト
AuthType Basic
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
TeamFile にログインする為の認証方式を指定します。TeamFile では Basic 認証のみをサポートしておりますので、変更しないようお願い致します。
2.4 より teamfile という文字列固定となります。
AuthName¶
役割
ログインダイアログの「領域」という項目に表示される文字列。（Apache 本体が定義）
構文
AuthName（文字列）
デフォルト
なし
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
TeamFile では直接利用されません。多くの場合、Web ブラウザや一般的な WebDAV クライアントからのログインの際に、ログインダイアログ上に表示されます。
TfAuth（2.2.0 で廃止）¶
TeamFile サーバー2.2.0 ではこのディレクティブは意味を持ちません。
設定されていても無視されます。
役割
TeamFile の認証機構をどのモジュールとするか
構文
TfAuth [ on | （認証モジュールの名称） ]
デフォルト
TfAuth On
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
TeamFile の Basic 認証を利用する場合「On」に設定します。通常は、デフォルトのまま変更しないようお願い致します。認証モジュールの名称を指定することで、その機能を利用した認証が実施可能ですが、 TeamFile 独自の機構が一切ご利用いただけなくなります。
TfEncryptPassword¶
役割
リポジトリデータベース内に保管されたユーザのパスワードを暗号化して保持するかどうか指示する
構文
TfEncryptPassword [ on | off ]
デフォルト
TfEncryptPassword off
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
TeamFile のリポジトリデータベースで保持する接続ユーザのパスワードを符号化（MD5）して保存します。このディレクティブを設定しない場合、パスワードはそのまま格納されます。
なお、この設定は導入初期時に決める必要があります。運用が開始してからの変更はできませんのでご注意ください。
TfUseSession（2.1.5-1 以降）¶
役割
ブラウザのログインを Basic 認証から POST 認証へ変更する
構文
TfUseSession [ on | off ]
デフォルト
TfUseSession on
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
2.1.5-1 以前はユーザ認証は Basic 認証のみでしたが、この機能を有効にする事によりブラウザからのアクセスに限り POST 認証を行うことができます。
POST 認証にすることにより以下の動作も可能となります。
1． 明示的なログアウト
2． 利用言語の設定
TfSessionTimeOut（2.1.5-1 以降）¶
役割
ブラウザのログイン有効時間を設定します。
構文
TfSessionTimeOut XXX秒
デフォルト
TfSessionTimeOut 0 (無制限)
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
ブラウザでなにも操作をしていない時自動的ログアウトする時間。
TfFailedLoginControl（2.1.6-4 以降）¶
役割
ログイン時の認証誤りによるユーザロックアウト（ログインできないようにする）をどのように取り扱うかを決定します。
構文
TfFailedLoginControl 数字 数字 数字
デフォルト
TfFailedLoginControl 5 60 3
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
ログイン認証に失敗した場合に、本ディレクティブに従って対象のユーザアカウントのロックアウトを制御します。ロックアウトされたユーザについては、管理者と本人にメールで通知されます。引数は 3 つの数字です。
| 引数 | 意味 | 範囲 |
|---|---|---|
| 第一引数 | ログイン認証を失敗できる回数。この回数までパスワード誤りが行えます。0 にすると本機能は有効になりません。 | 0 ～ 2,147,483,647 |
| 第二引数 | 失敗してから再チャレンジできるまでの秒数 | 0 ～ 2,147,483,647 |
| 第三引数 | 失敗と再チャレンジを何回まで繰り返せるか | 0 ～ 2,147,483,647 |
5 60 3 の場合、パスワードを 5 回誤るとアカウントがロックされますが、60 秒後に再度挑戦できます。これを 3 回繰り返すと永久ロックとなり、メールが送られます。
永久ロックの解除やロックアウト時の通知メールについては、ユーザロックアウトの機能を理解する を参照してください。
TfUseSAML（2.4.0-1 以降）¶
役割
SAML 認証の有効無効を設定します。
構文
TfUseSAML On / Off
デフォルト
TfUseSAML Off
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
SAML 認証の有効無効の設定をします。ここの項目が Off の場合は同じ SAML 系の設定が有効（コメントアウトされていない）であっても無効になります。
TfSAMLIdPMetaDataPath（2.4.0-1 以降）¶
役割
SAML 認証の IdP のメタデータの保存パスを指定します。（フルパスで設定してください）
構文
TfSAMLIdpMetaDataPath /usr/local/teamfile/www/conf/saml/idpmeta.xml
デフォルト
未設定
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
SAML の認証情報を取得する Idp のメタデータのファイルを指定します。TeamFile では SAML 関連ファイルの保存パスに/usr/local/teamfile/www/conf/conf.d/saml を提供しています。 フルパスで設定してください。
TfSAMLXMLPrivateKeyPath（2.4.0-1 以降）¶
役割
TeamFile から SAML リクエスト（AuthnRequest）に XML 署名する場合の秘密鍵のファイルパス
構文
TfSAMLXMLPrivateKeyPath /usr/local/teamfile/www/conf/saml/private.key
デフォルト
未設定
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
SAML の Idp からの要請で、XML 署名を行わなければならない場合があります。
このディレクティブで XML 署名を行うための秘密鍵のパスを指定します。
XML 署名を行う秘密鍵は通常 SSL で利用している秘密鍵と同じで構いません。
TfSAMLXMLPublicCertificatePath（2.4.0-1 以降）¶
役割
TeamFile から SAML リクエスト（AuthnRequest）に XML 署名する場合に追加する公開鍵のパス
構文
TfSAMLXMLPublicCertificatePath
/usr/local/teamfile/www/conf/saml/public.key
デフォルト
未設定
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
SAML の Idp からの要請で、XML 署名を行わなければならない場合があります。
XML に署名を行った場合に、その署名を確認するための公開鍵を XML に埋め込みます。
TfSAMLMatchedMailAddr（2.4.0-1 以降）¶
役割
SAML での NameID（ユーザ ID）と TeamFile の ID とのマッチングを行いユーザを決定するのではなく TeamFile のメールアドレスを利用してログインを行う仕組みを提供します。
構文
TfSAMLMatchedMailAddr On / Off
デフォルト
TfSAMLMatchedMailAddr Off
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
SAML の IdP から認証が成功した場合の戻ってくる NameID を利用して通常はログインを行います（Off の動作）。
On にすると、TeamFile のメールアドレスを利用してログインを試みます。メールアドレスはユニークではない為、複数人ヒットする可能性もあります。複数人ヒットした場合は、対象ユーザの一覧を表示させ選択後にログインが行えるようになります。
TfTwoFactorAuthentication（2.5.0-1 以降）¶
役割
二段階認証を有効にします。
構文
TfTwoFactorAuthentication [ on | off ]
デフォルト
TfTwoFactorAuthentication off
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
TeamFile のログインが二段階認証となります。2.5.1-0 では、通常ログインは二段階認証にならず BOX だけが対象となります。 適用範囲は TfTwoFactorAuthenticationStage で設定します。
TfTwoFactorAuthenticationCycle¶
役割
二段階認証を要求する期間と時刻を設定します。
構文
TfTwoFactorAuthenticationCycle [ 0-23 ] [ 0d - 365d | 0m - 12m ]
デフォルト
TfTwoFactorAuthenticationCycle 9 6m
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
二段階認証を要求する期間を短くしてセキュリティを高めたり、期間を長くとることで煩雑な要求を抑えたりできます。 なお、2.5.0-1 では二段階認証の対象が BOX だけのため、期間は意味を持ちません。
TfTwoFactorAuthenticationType¶
役割
二段階認証の方式を設定します。
構文
TfTwoFactorAuthenticationType [ default | otp-only ]
デフォルト
TfTwoFactorAuthenticationType default
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
二段階認証は対象ユーザにメールアドレスが設定されていることが条件ですが、メールアドレスを持たないユーザに対して OTP による認証を行えるようにできます。
| 値 | 動作 |
|---|---|
default |
パスワード認証と TOTP のパスワードを利用します。 |
otp-only |
OTP のみをパスワードとして利用します。通常のパスワードは利用できなくなります。LDAP も利用できません。 |
TfTwoFactorAuthenticationStage¶
役割
二段階認証を適用する範囲を設定します。
構文
TfTwoFactorAuthenticationStage [ all | box ]
デフォルト
TfTwoFactorAuthenticationStage all
コンテキスト
ディレクトリ設定ファイル (new_xxx.conf)
説明
二段階認証を行う箇所を BOX だけに限定できます。
| 値 | 動作 |
|---|---|
all |
すべてに適用します。 |
box |
BOX だけに適用します。 |