Managing access to your service project

Go to Project settings > Customer permissions to choose who can raise requests in your service desk and who your customers can share requests with.

On this page:

Choose who can raise requests

People need to be customers to raise requests in your service desk. You can let your team control who becomes a customer, or let customers create their own accounts in your service desk.

Who can raise requestsDescription
Customers who are added to the projectYour team adds customers to the project via the Customers page, or by raising requests on their behalf.
People with accounts on your Jira site are automatically added to the Customers list and can raise requests.
Anyone can email the service project or raise a request in the portal
  • New customers can create their own accounts in your service desk via the customer portal.

  • Raising an email request automatically creates an account for the sender.

  • If you allow customers to share requests, then people they share with also become customers and can raise requests.

  • A honeypot technique is enabled to help prevent spambots from creating accounts through the customer portal.

  • If login-free portal has been enabled by your Jira administrator, and this option is selected, anyone will be able to access your portal and raise requests without logging in. Learn more about login-free portal

If this option is disabled, then your Jira administrator has not turned on public signup for service desks on this Jira site. Learn more about enabling public signup

When you choose this option, you have no control over who can create an account and raise requests. We strongly recommend that you use the Customers who have an account on this Jira site option instead, unless the requirement for a Jira account won’t work for your use case.

Read more in our security advice

Choose who customers can share requests with

You can allow customers to share requests with their organizations, Jira groups they're part of, anyone in the service desk, or people who aren't customers yet. The people customers share with become participants in the request. Request participants can comment on and share requests, and receive the same notifications from Jira Service Desk as the reporter. Learn more about request participants

The following table describes the ways customers can share requests:

Who customers can share withDescription
Other customers in their organization
  • Customers can share requests with their organization, or raise a private request.
  • Customers can search their organization for people to share with:
  • Customers who aren't in an organization can't share requests.

Customer sharing request with other customer

Any customer, by typing an email address

Customers can share requests with other customers in their organization (like in the option above), and also:

  • Share requests with anyone in the service project, if they know their email address
  • If anyone can email the service project or raise a request in the portal, then customers can also share requests with people who aren’t customers yet. They can provide email addresses of these people and Jira will create accounts for them. Such unregistered email addresses can only be entered in the Share this request field but not a regular user picker field.
Any customer or organization, by searching in this project
  • Customers can share their requests with anyone in the project. They can also search the service project for people to share with.
  • If anyone can email the service project or raise a request in the portal, then customers can also share requests with people who aren’t customers yet. They can provide email addresses of these people and Jira will create accounts for them. Such unregistered email addresses can only be entered in the Share this request field but not a regular user picker field.

If your service project uses user picker custom fields, such as the Approvers field, choose this setting to make sure customers can select users.

Choose whether customers can share requests with groups

Agents and project admins can share requests with Jira groups added as customers of the service project in the issue view. Project admins can choose to extend this sharing capability to help-seekers, allowing them to share requests with Jira groups they’re part of from the customer portal without additional permission management. 

To allow sharing with groups, select the Allow sharing with customer groups added to this project checkbox under Can customers share requests with groups? 

Choose whether customers can vote for requests

You can allow customers to vote for requests directly in the customer portal. This lets them cast their votes for requests they'd like to see done without having user accounts on your Jira instance. 

To enable voting in the portal, you need to have global voting enabled for your Jira instance.

The following table describes different options for this setting:

Can customers vote in the portal?Description
Yes, any customer with portal access can vote directly in the portal

Customers will see an extra option to vote when they view a request in the portal. They can then add their vote or remove it.

No, customers can't vote directly in the portal

If the global voting is enabled, users with accounts on your Jira instance will still be able to vote for requests if they view them directly in Jira. Customers might not have such accounts, so this option will essentially limit voting to your agents.



Which settings are best for my team?

Not sure how to set up permissions for your team? Here are some suggestions for how to make customer permissions work for you:

If you're like thisWho can raise requestsWho customers can share withCan customers vote?
You have a service project that handles contractors' leave requests. Only contractors can use the service project, and you don't want non-contractors to get confused about where to request leave. Customers who are added to the projectOther customers in their organization

No, as contractors probably don't need to vote for their leave requests.

Your company has an IT service desk, and you want all employees to be able to create their own accounts and email requests. Customers who have an account on this Jira siteAny customer or organization, by searching in this project

No, if your team is mostly handling requests for individual employees, such as "I need a new monitor".

Yes, if your team is handling requests for general improvements. For example, employees could vote for what they'd like to be added to their office.

Your team provides software support for individuals. For example, if your company makes a free SAAS application that individuals use to manage finances, you can let your customers email bugs and questions to your service project email channel.Anyone can email the service project or raise a request in the portalAny customer, by typing an email addressYes, it might be useful for individuals to vote for bugs or requests they'd like to see fixed first.

Security advice: Choosing who can raise requests

This is security advice regarding the option Who can raise requests.

When allowing anyone to create and raise requests, we strongly recommend that you use a separate domain for your incoming email account and configure this account to filter against automatic emails by blocking the addresses with a local-part, such as “no-reply”, “support”, “servicedesk”, and so on.

Reason

Configuring your Jira Service Management instance using an incoming email address with a domain at your company level can result in bad actors abusing the system to gain access to restricted services.

Example

For example, assume that your domain is http://mycompany.com, and you have set up a customer portal with an incoming email support@mycompany.com, allowing anyone to create and raise requests. Now, let’s say a bad actor is trying to gain access to teamsinspace.com for which your company already has an account (e.g. admin@mycompany.com).

If the bad actor creates a new ticket in your customer portal and adds no-reply@teamsinspace.com as a participant, they can now go to teamsinspace.com and open an account for support@mycompany.com and provide a team name including the ticket number. Since teamsinspace.com includes the team name in their confirmation emails (and other websites might include other details), such an email will be sent to your incoming email address in Jira Service Management, and added as a comment to the ticket. By clicking on the confirmation email, the bad actor could open an account on teamsinspace.com on behalf of your company.

Mitigating this issue

Using a separate domain or sub-domain dedicated for your customer portal will help prevent this as long as you make sure to not sign up to services using that domain. What’s more, adding filters against automatic emails (e.g. “no-reply”) at the incoming email account level will further help mitigate the issue because no-reply emails will be blocked.

Last modified on Aug 8, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.