====================================================================
  KOLHAPUR LAND PORTAL — DSC AGENT SETUP GUIDE (OFFICER COMPUTER)
====================================================================

This guide is for OFFICERS who sign documents digitally (DSC).
Run these steps ONCE on your office computer.

====================================================================
STEP 1: INSTALL THE DSC AGENT (one-time setup)
====================================================================

1. Get the "DSC-Agent-Package" folder from your IT/admin
   (It contains: KolhapurDSCAgent.exe, START-DSC-AGENT.bat, INSTALL-DSC-AGENT.bat)

2. Right-click "INSTALL-DSC-AGENT.bat"
3. Click "Run as administrator"
4. Follow the on-screen steps

   After installation you will see "Start DSC Agent" on your Desktop.

====================================================================
STEP 2: DAILY USE — HOW TO SIGN DOCUMENTS
====================================================================

Every time you want to sign a document:

   1. Plug in your mToken USB device into a USB port on your computer

   2. Double-click "Start DSC Agent" on your Desktop
      → A black window will open showing:
         ✔ Token detected: Longmai mToken CryptoID
      → Keep this window OPEN

   3. Open your browser
      Go to the Kolhapur Land portal (ask your IT for the address)

   4. Navigate to the document you need to sign

   5. Click "Sign Document"
      → The portal will detect your USB token automatically
      → Enter your token PIN when asked
      → The document will be signed

   6. When done signing for the day:
      → Close the black "DSC Agent" window

====================================================================
IMPORTANT NOTES
====================================================================

  ★ The black agent window MUST stay open while signing.
    If you close it, the portal cannot detect your token.

  ★ Your mToken USB MUST be plugged in before starting the agent.

  ★ If you see "No signing agent detected" in the portal:
    → Check if the black agent window is open
    → If it shows an error, try unplugging and re-plugging the USB

  ★ If the portal asks for a PIN that is wrong / locked:
    → Contact your DSC provider (LONGMAi / eMudhra / Capricorn)
    → Do NOT try the PIN more than 3 times (the token may lock)

  ★ The agent ONLY works on your local computer.
    It does NOT send your private key anywhere. Signing happens locally.

====================================================================
TROUBLESHOOTING
====================================================================

Problem: Agent window shows "No USB token detected"
Fix    : Unplug USB and plug it back in, then restart the agent.

Problem: Browser shows "No signing agent detected on this PC"
Fix    : The agent window is not running. Double-click "Start DSC Agent".

Problem: "Signing failed" error
Fix    : Enter PIN via mToken Certificate Utility once, then try again.

====================================================================
SUPPORT
====================================================================

For technical issues, contact your IT administrator.
For token PIN reset, contact: LONGMAi / eMudhra / Capricorn support.

====================================================================
