OXIAE / SOFTWARE DEVELOPMENT

Customer portal development.

Give customers their own space for information, requests and progress.

Discuss your project
UNDERSTAND THE SERVICE

What should a first customer portal let your customers do?

A customer portal gives customers access to the requests, progress and documents intended for them. A first version might support three tasks: submit a request, check progress and retrieve a document. We define which organisation and records belong to the user and which actions are permitted. The visible customer status is deliberately mapped from the internal process; internal notes and handling steps are not automatically published.

When it is a good fit

This fits when customers repeatedly request the same information or track requests through separate emails. A CRM integration can supply customer and organisation details. Internal follow-up can stay in existing workflow software, while the portal supports only the agreed customer tasks.

When to take a different approach

An existing customer area may be sufficient if it already supports the tasks, permissions and source information. Unclear statuses or responsibilities need defining first. Adding a new screen does not resolve an unclear internal process.

PRACTICAL DECISION GUIDE

A customer portal needs checks per customer and record

A customer portal gives external users access to organizational information. I distinguish signing in from being authorized to view a record. Each user, organization and document gets defined actions, including downloads, uploads and inviting colleagues. [1]

Authorization is checked on the server and tested with direct links to other records. Account lifecycle matters too: invitations, departing employees and revoked access. The portal should clearly show whether an upload, change or request succeeded and how users can recover from errors. [2][3]

Questions to settle first

  • Who manages users within each customer organization?
  • Which record links must never reveal information across customer boundaries?

Make acceptance measurable

  • Tests with two customer organizations, revoked access and shared links.
  • A complete task tested with error messages and keyboard operation.
Illustrative access plan — not a customer case

What may each user do in the customer portal?

Example agreements for a first B2B portal: the role, customer organisation and record assignment determine access together. Access that has not been granted is denied. This is a design proposal; it does not describe a customer implementation or show the result of a security test.

Example roles, information and permitted actions
UserInformationPermitted actionsBoundaries
Customer employeeRecords from their own customer organisation that have been released to this account.Submit requests, follow the visible status and download released documents. Submit changes to a finalised record as a change request.No records from other organisations or internal notes. This customer role does not allow users to manage colleagues or their permissions.
Internal case handlerAssigned customers and records the case handler is authorised to work on.Review requests, update the agreed statuses and release selected documents to the customer. Keep internal notes separately.No automatic access to unassigned customers. Saving a document or note internally does not publish it to the customer.
AdministratorAccounts, roles and organisation memberships within the agreed administrative mandate.Invite or block users and manage their organisation memberships and role assignments.Administrative permissions do not automatically grant access to record contents. An additional viewing role is approved and granted separately.

On a narrow screen, scroll the table sideways to read each column.

Checks to agree before delivery

  • Try a direct document link and a different record or document identifier. On each request, the server checks whether this user may open or change the requested content.
  • Use test accounts from two customer organisations and an unassigned case handler. Selecting a different organisation or customer must not expose additional records.
  • A blocked account receives no new access. Also check existing sessions and download links, and agree in advance how they expire or are revoked.
  • Add an internal note to a visible record. It stays out of customer views, search results, notifications and downloads, including direct requests.
  • Define which fields a customer may change at each status. A change to a finalised record follows the agreed review step and does not overwrite approved data, including through a direct update request.

Compare your options

Choose based on the task, the people involved and what you can maintain.

ApproachUseful whenWhat to consider
An existing product's customer areaThe required customer tasks and access rules are already available.Also check organisation boundaries, invitations, revoked access and the meaning of displayed statuses.
A custom customer portalCustomers need a specific combination of tasks and information from several systems.Data boundaries, source integrations and operation belong in the scope alongside the screen.
A broader web applicationSeveral user groups need more extensive functions than the selected customer tasks.A portal can technically be a web application; the customer tasks define its functional scope.
Internal workflow softwareThe main question concerns employees, task allocation and approvals.That processing can remain behind the portal; not every internal step needs to be customer-facing.

What I need to start

  • A limited first version with specific customer tasks, required fields and responsibility for handling submitted requests.
  • A mapping between users, customer organisations and permitted records. Define separately who invites customer users, assigns roles and revokes access.
  • A source, owner and refresh agreement for each customer-visible field. Internal statuses need explicit customer labels; notes and documents have separate visibility rules.
  • Supported access to source systems. An API integration needs rules for creation, changes, retries and an uncertain outcome after an outage.
  • A manual contact and handover route during an outage, plus an operator responsible for access, alerts, source changes and operational handover.

How to assess the result

  • The agreed customer tasks work with normal and incomplete input; a request receives a recognisable receipt status without implying processing or approval.
  • The access-plan checks and invitation expiry are assessed with the agreed test accounts. For previously issued download links, the policy defines how and when they expire or are revoked.
  • Customer labels match the agreed source status. Internal notes and fields outside the selected scope do not appear in the customer view.
  • Source outages remain recognisable alongside the last successful refresh. An uncertain submission receives neither a false success message nor uncontrolled duplicate processing; the manual next step is visible.
  • Handover documents customer tasks, permissions, status mapping, sources, failure handling and responsibilities for everyday operation.
SCOPE & INVESTMENT

What determines the cost?

A useful estimate starts with the scope. I distinguish development work from recurring usage and operating costs. These are the main drivers:

  • A focused first version: selected customer tasks, user roles, screens and source information, with additional features kept separate in the scope.
  • Production operation: invitations and revocation, record and document access, source integrations, alerts, recovery and operator instructions.
  • Migration of existing customers and documents, unusual customer organisations and additional approval steps are scoped separately.
  • Hosting, storage, any provider licences, monitoring and maintenance of integrations and access determine recurring costs.
APPLICATION AND SCOPE

Your challenge.
A practical application.

Illustrative scenario; not a published client case.

Customers regularly ask for information or status updates already available internally.

A customer portal gives external users access to a defined part of your information. A CRM integration can supply customer records, while API integration handles exchange with other systems. Define who may view, change and approve each type of information.

THE QUESTION I ASK FIRST

What may customers view, change and request themselves?

Agree the first step

Use the prerequisites, acceptance checks and cost factors above to define your assignment. Agree who can approve the outcome and who will maintain the solution. The project approach explains discovery, delivery and handover.

Read the project approach
QUESTIONS ABOUT THIS SERVICE

Your questions.
Clear answers.

Do we need a custom customer portal, or is our current software enough?

I first compare the desired customer tasks with the existing customer area. Configuration may be sufficient if requests, documents, permissions and statuses are adequately supported. Custom development becomes useful for specific limitations or essential connections between systems.

Can the portal keep using our CRM or administrative system?

A portal can often connect to existing sources if access, fields and licences support it. We agree which system remains authoritative and whether the portal only reads or also submits changes. A new central administrative system is not automatically required.

How do you test that customers only see their own information?

We define the relationship between users, organisations and records, then test it through server requests, details and documents. Acceptance includes other organisations, expired invitations and revoked access. Hiding a button or field alone is insufficient.

Who operates the portal, and what happens when a source is unavailable?

Handover establishes who manages access and alerts, and how manual takeover works. An outage has a recognisable status and contact route. Availability, support, response times and further development are agreed separately.

Sources and technical basis

These primary sources explain the technical principles behind this guide. The project recommendations are OXIAE’s interpretation; they do not imply endorsement by the publishers. Product documentation applies to the named platform.

  1. Authorization Cheat SheetOWASP

    Checking access for each user and requested object.

    Link and relevance checked:
  2. File Upload Cheat SheetOWASP

    Technical considerations for files uploaded by customers.

    Link and relevance checked:
  3. Web Content Accessibility Guidelines (WCAG) 2.2W3C

    Criteria for accessible tasks and feedback.

    Link and relevance checked:
YOUR NEXT STEP

Prepare your project conversation.

Exploring Customer portal development? Use the project checklist to describe your task, systems and intended outcome. Collect open questions and download a brief for your conversation.

Create your project brief
FROM QUESTION TO NEXT STEP

What would you like
to make possible?

Let’s talk