Detailed information for the notes.ini Keyword: 


Short Description: Can be used to enable/disable a security (against Cross-Site Scripting (XSS)) enhancements in iNotes


If your environment contains multiple DNS domains, and the unauthorized domain reported in the Server Console Display (e.g., as shown in the table above) is actually one of the domains in your environment, then it is likely that there is a configuration issue.

If none of the configurations described in the Problem section above applies to you, then your server may have been the target of a Cross-Site Request Forgery attack. If that is true, the information in the error message may be able to help you identify the attacker and/or the user account that was targeted. For example, in the following error message, the mail file targetmail.nsf was the target of the blocked request. The request is likely to have originated by a page loaded from the site

11/13/2009 11:49:15.73 AM [02E4:000B-0F40] XSS:> Referer Check Error: Request originated from a different domain: baddomain.
Bad Request: /mail/targetmail.nsf/($Inbox)/$new/?EditDocument&Form=h_PageUI&PresetFields=s_ViewName;(%24Inbox),s_NotesForm;Journ
11/13/2009 11:49:15 AM iNotes XSS Security: Referer Check Error: Unauthorizeddomain attempted to issue an iNotes command. Request not processed

If you have determined that you have been the target of an attack, take appropriate measures to respond to the situation. For information about these types of attacks, see Cross-Site Request Forgery page from OWASP.

If the Referer value is invalid or removed by a proxy server, or if it references a different second-level HTTP domain than that of the iNotes server, then you need to change your configuration. Use the table below and the scenarios provided in this section to determine the relevant Notes.ini setting you may need to add, based on your configuration.
Note that the Domino console command set config can be used to modify these settings and avoid a restart of the entire Domino server. After setting the value just restart Domino HTTP task and the setting will take effect. For example:

    > set config iNotes_WA_Security_RefererCheck=0
    > tell http restart

Possible values:

Values Behavior
Referer header checking is disabled
Strict Referer header checking is enabled (default) - Post requests must have a Referer header. If a whitelists exists, the Referer header must match an entry there. If no whitelist exists (default), the Referer header must match the server's domain.
Lenient Referer checking is enabled - Post requests are not required to have a Referer header. If a Referer header does exist and if a whitelists exists, the Referer header must match an entry on the whitelist. If a Referer header does exist and no whitelist exists, the Referer header must match the server's domain.
<domain> Explicitly defines Referer headers that will be accepted, for example

Default value:

iNotes_WA_Security_RefererCheck=0 / 1 / 2


UI equivalent:
There is no kown UI setting for this notes.ini variable. But you can specify this setting in the notes.ini settings tab of the configuration settings document.

Applies to:

Valid for version: