メールによるチケット登録で発生するエラーの意味と対処方法

特定のアドレスにメールを送ることでチケットを登録する機能でエラーが発生すると、エラー内容がメールで返されます。

以下はメールの例です。エラーメール内にRedmineが返したエラーメッセージが挿入されます。

This is the mail system at host redmine.example.com.

I'm sorry to have to inform you that your message could not be delivered to
one or more recipients. It's attached below.

For further assistance, please send mail to <postmaster>

If you do so, please include this problem report. You can delete your own
text from the attached returned message.

                   The mail system

<redmine@redmine.example.com>: permission denied. Command
    output: Request was denied by your Redmine server. Possible reasons:
email
    is sent from an invalid email address or is missing some information.

エラーメッセージと考えられる原因

Request was denied by your Redmine server. Make sure that ‘WS for incoming emails’ is enabled in application settings and that you provided the correct API key.

設定「受信メール用のWebサービスを有効にする」が有効になっていないか、APIキーが誤っています。

  • 「管理」→「設定」画面の「受信メール」タブを開き、「受信メール用のWebサービスを有効にする」が有効になっていることを確認してください。
  • メールによるチケット登録の設定で使用したAPIキーと「受信メール」タブで登録したAPIキーが一致していることを確認してください。

Request was denied by your Redmine server. Possible reasons: email is sent from an invalid email address or is missing some information.

Redmineに登録できないメールアドレスでチケットを登録しようとしたか、チケットを登録するために必要な情報が不足しています。

  • Fromのメールアドレスが以下のいずれかに当てはまっていないか確認してください。
    • Redmine上に登録されていないメールアドレス
    • ロックされているユーザーのメールアドレス
    • 指定されたプロジェクトにチケットを登録する権限がないユーザーのメールアドレス
    • Redmineの「管理」→「設定」→「メール通知」→「送信元メールアドレス」に設定されたメールアドレス
  • メールの本文内で、チケット登録に必要なキーワードの記述が抜けていないか確認してください。
    • project キーワードが漏れていないか( rdm-mailhandler.rb--project オプションを指定しない場合)
    • 必須入力に設定してある標準フィールドおよびカスタムフィールドの記述が漏れていないか
    • カスタムフィールド名が誤っていないか

Redmineのインストールディレクトリの logs/production.log を確認すると、次のようにエラーの原因が記録されていることがあります。

MailHandler: Validation failed: 担当者 を入力してください, カテゴリ を入力してください, 期日 を入力してください

参考

メールによるチケット登録で使用できるキーワード

Request was denied by your Redmine server (4xx).

上記以外の何らかの問題が発生しました。@rdm-mailhandler.rb@ から --url オプションで指定されたRedmineのURLにアクセスしたときにHTTPの400番台のエラーコードが返された(アクセスが拒否された)場合のエラーメッセージです。

Redmineのインストールディレクトリの logs/production.log を確認してください。

Failed to contact your Redmine server (5xx).

処理中にRedmine内部で何らかのエラーが発生しました。 rdm-mailhandler.rb から --url オプションで指定されたRedmineのURLにアクセスしたときにHTTPの500番台のエラーコードが返された(内部エラーが発生した)場合のエラーメッセージです。Redmineが正しく動作していない可能性があります。

Redmineのインストールディレクトリの logs/production.log を確認してください。