OptimiDoc Server Help Center

Konica Minolta

Konica Minolta multifunction devices are fully supported by OptimiDoc through the OpenAPI integration framework. This page describes how the integration works under the hood, lists the supported models, documents the available authentication methods and terminal layouts, and covers firmware requirements and known limitations.

Konica Minolta is an embedded-terminal vendor: OptimiDoc installs an application directly onto the device control panel, so the device can lock the panel behind authentication, release held print jobs, start scan workflows, and report copy/print counters back to the server in real time.


Integration Method

OptimiDoc integrates with Konica Minolta devices via the OpenAPI framework — Konica Minolta's open platform for embedding third-party applications into the device control panel. OptimiDoc registers itself as an OpenAPI application (identified by a licensed solution key) that provides:

  • A custom login screen for card, PIN, and login/password authentication.

  • A pull-print job list for releasing held jobs at the device.

  • Scan-to-workflow buttons that launch OptimiDoc scan templates on the panel.

  • Copy, print, and scan accounting hooks with per-user function limitation (access rights).

The device and the OptimiDoc server communicate over SSL on port 14267. Installation is performed remotely from the OptimiDoc web interface using the device's administrator credentials.

Note: Konica Minolta and Develop devices share the same OpenAPI platform. The configuration and behaviour described on this page applies equally to Develop-branded (ineo) devices. See the Develop page.


How the Integration Works

1. Remote installation

When you install OptimiDoc onto a Konica Minolta device from the web interface, OptimiDoc chooses one of two installers based on the configured terminal layout:

  • Web installer — used for any layout above Legacy (Classic, Classic Large/Small Display, Modern). This registers the modern browser-based terminal that renders the OptimiDoc web UI on the panel.

  • Classic installer — used for the Legacy layout, registering the original panel application.

In both cases OptimiDoc uploads its licensed solution key and application icons, localises the button labels into every enabled language, and enables the OptimiDoc application on the panel. The Default Application setting, if enabled, makes the OptimiDoc terminal launch automatically when a session begins instead of requiring the user to pick it from the device's application list.

2. Authentication flow

OptimiDoc runs two OpenAPI authentication endpoints for Konica Minolta: an authentication server for the classic panel and a browser authentication server for the web terminal. When a user authenticates at the panel, the device calls back to OptimiDoc, which:

  • Reads the card number (for card-based methods) or the PIN / login credentials entered on screen.

  • Resolves the user, and if the card is unknown, optionally starts card self-assignment (the user registers an unknown card by confirming a PIN or login/password).

  • Returns a function-limitation response that enforces the user's access rights — allowing or blocking copy, monochrome print, colour print, scan, and colour send individually.

3. Job accounting (push-based)

Konica Minolta accounting is event-driven, not polled. After each job the device sends a counter notification to OptimiDoc containing the full colour/monochrome, copy/print, small/large, and duplex counters. OptimiDoc converts this into an accounting record and attributes it to the logged-in user immediately — there is no accounting poll interval to tune. Logout notifications close the user session.

4. Scan path

Scan workflows are driven natively by the device: OptimiDoc sends the scan settings to the panel over OpenAPI, the device performs the scan, and the resulting file is delivered through the OptimiDoc scan pipeline.

5. Uninstallation

Uninstalling from the web interface removes the OptimiDoc OpenAPI application and its authentication registration from the device, returning the panel to its previous state.

Diagnostics (26.07): OptimiDoc now logs the specific failure reason when a server-to-device (web → MFP) OpenAPI call is rejected — for example when closing the terminal, switching to copy, or refreshing the browser screen. Previously these failures were silent; the device NACK reason is now written to the log to speed up troubleshooting.


Authentication Methods

The authentication methods offered for a Konica Minolta device depend on whether Device Authentication is enabled. Device Authentication means OptimiDoc locks the device panel and authenticates every walk-up user; when it is disabled, the panel is not locked and OptimiDoc identifies the user through Single Sign-On only.

When Device Authentication is enabled

Description

PIN

User enters a numeric PIN code.

Login and Password

User enters a username and password.

Card

User taps a card on the device's card reader.

Card or PIN

User may authenticate with either a card tap or a PIN.

Card or Login and Password

User may authenticate with either a card tap or credentials.

Card and PIN

Two-factor: card tap and PIN.

Card and Login and Password

Two-factor: card tap and credentials.

External Authentication

Authentication delegated to an external system via the OptimiDoc External Authentication API.

When Device Authentication is disabled

Description

Single Sign-On

The only method available. The device panel is not locked; the OptimiDoc terminal identifies the user via the organisation's SSO provider.

Konica Minolta specifics: Single Sign-On is available only when Device Authentication is disabled, and the User List method (choosing a name from an on-screen list) is not offered for Konica Minolta devices. Card-based and External Authentication methods require Device Authentication.


Terminal Layout Options

Konica Minolta supports all five OptimiDoc terminal layouts:

Layout

Description

Legacy

The original panel application (installed via the classic installer).

Classic

Standard web terminal with optimised navigation.

Classic (Large Display)

Optimised for devices with large touchscreen panels.

Classic (Small Display)

Optimised for devices with compact touchscreen panels.

Modern

The latest web terminal design with enhanced visual elements.


Supported Models

Bizhub i-Series (Colour)

Model

Minimum Firmware

Notes

bizhub C250i

G00-35 or later

Full feature support

bizhub C300i

G00-35 or later

Full feature support

bizhub C360i

G00-35 or later

Full feature support

bizhub C450i

G00-35 or later

Full feature support

bizhub C550i

G00-35 or later

Full feature support

bizhub C650i

G00-35 or later

Full feature support

Bizhub i-Series (Black & White)

Model

Minimum Firmware

Notes

bizhub 300i

G00-35 or later

Full feature support

bizhub 360i

G00-35 or later

Full feature support

bizhub 450i

G00-35 or later

Full feature support

bizhub 550i

G00-35 or later

Full feature support

Bizhub C-Series (Previous Generation)

Model

Minimum Firmware

Notes

bizhub C258

GC7-X8 or later

Supported; no scan-to-workflow on older firmware

bizhub C308

GC7-X8 or later

Supported

bizhub C368

GC7-X8 or later

Supported

bizhub C458

GC7-X8 or later

Supported

bizhub C558

GC7-X8 or later

Supported

bizhub C658

GC7-X8 or later

Supported


Supported Features

Feature

Status

Notes

Pull print (release at device)

Supported

Card, PIN, or username/password authentication

Scan to workflow

Supported

Templates displayed on device panel; requires i-Series firmware G00-35+

Copy/print accounting

Supported

Real-time, push-based per-page colour/BW tracking with department codes

Card authentication

Supported

USB and built-in card readers; HID, Mifare, FeliCa

Card self-assignment

Supported

Unknown card registered by PIN or login/password

PIN authentication

Supported

Configurable PIN length

Function limitation (access rights)

Supported

Copy, mono/colour print, and scan allowed per user

Device monitoring (SNMP)

Supported

Toner levels, paper trays, page counts, error status

Agent remote installation

Supported

Requires device admin credentials and OpenAPI enabled

Secure print release

Supported

Jobs encrypted in transit and at rest

Remote login/logout (unlocking the panel from the OptimiDoc web/mobile app) is not available on Konica Minolta; authentication is performed at the device panel.


Prerequisites

Before installing the OptimiDoc agent on a Konica Minolta device:

  1. Enable OpenAPI on the device. Navigate to the device web interface > Security > OpenAPI Settings and ensure OpenAPI is enabled with SSL.

  2. Set authentication to External Server. Under Authentication settings, set the login method to "External Server Authentication" so the OptimiDoc agent handles login.

  3. Configure SNMP for monitoring. Ensure SNMPv2c is enabled with a known community string (or configure SNMPv3).

  4. Note the device admin credentials. The OptimiDoc installer requires these to deploy the agent remotely.


Known Limitations

  • C-Series scan templates: On bizhub C-Series devices with firmware older than GC7-X8, scan-to-workflow is not available. Users must use the built-in scan function and route via the server.

  • OpenAPI licence: Some older models require a separately purchased OpenAPI licence. The i-Series includes OpenAPI by default.

  • Concurrent sessions: OpenAPI supports a limited number of concurrent sessions. In high-traffic environments, ensure the session timeout is set appropriately.


Firmware Update Notes

Always test firmware updates on a single device before rolling out to the fleet. Konica Minolta firmware updates occasionally change OpenAPI behaviour. After a firmware update:

  1. Verify the OptimiDoc agent is still installed and functioning.

  2. Test authentication, pull print release, and scan workflows.

  3. Check the OptimiDoc logs for any new errors related to the device.


In Summary

Konica Minolta devices integrate through the OpenAPI embedded platform over SSL. OptimiDoc installs a panel or web terminal, locks the panel behind card/PIN/login authentication when Device Authentication is enabled, enforces per-user access rights through function limitation, and accounts copies and prints in real time through device-pushed counter notifications. Single Sign-On is used when the panel is left unlocked. The same platform serves Develop-branded devices.


Related articles