Files
qbit-email/src/main/java/com/kingsrook/qbits/email/phi/EmailClassifications.java
T
james.maesandClaude Opus 5.5 10e96115f9 fix: review findings on templates, PHI and preview; add a local demo
- Template sends keep the template's category.
- Render budget (10,000 iterations, 1 MiB), nesting 8, linear parsing.
- URL attributes in HTML and MJML accept only http, https or mailto;
  unquoted attribute expressions are refused.
- MJML includes refused and disabled; the compiler runs with PATH only.
- Record variables load only referenced fields; records without a
  classification source are tokenized in snapshots.
- Approved templates keep their brand; brand URLs are https and image
  hosts are restricted for PHI mail.
- Viewers never trigger an MJML compile from the preview.
- Button links match a single link.
- PHI ciphertexts are bound to table, column and message (AES-GCM AAD).
- EmailDemoServer (test scope) seeds 24 hours of real traffic for
  screenshots.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 21:36:49 -05:00

110 lines
4.3 KiB
Java

/*
* QQQ - Low-code Application Framework for Engineers.
* Copyright (C) 2021-2025. Kingsrook, LLC
* 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
* contact@kingsrook.com
* https://github.com/Kingsrook/
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.kingsrook.qbits.email.phi;
import com.kingsrook.qbits.email.EmailQBitConfig;
import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
/*******************************************************************************
** STAND-IN(core=#1142, removeBy=RC.7). Core classification wins when available;
** overrides then schema declarations provide the RC.5 compatibility contract.
*******************************************************************************/
public final class EmailClassifications
{
/*******************************************************************************
** Ordered data sensitivity.
*******************************************************************************/
public enum Level
{
PUBLIC, CONFIDENTIAL, PII, PHI
}
/*******************************************************************************
** Utility class.
*******************************************************************************/
private EmailClassifications()
{
}
/*******************************************************************************
** Resolve a field without a compile-time dependency on unreleased core.
*******************************************************************************/
public static Level ofField(QTableMetaData table, String field, String declared, EmailQBitConfig config)
{
if(table != null && field != null)
{
try
{
Class<?> core = Class.forName("com.kingsrook.qqq.backend.core.actions.ai.AiDataClassifications");
Object value = core.getMethod("ofField", QTableMetaData.class, String.class).invoke(null, table, field);
if(value instanceof Enum<?> level)
{
return (Level.valueOf(level.name()));
}
}
catch(ClassNotFoundException e)
{
// Expected on RC.5; use the explicit stand-in configuration.
}
catch(ReflectiveOperationException | IllegalArgumentException e)
{
throw (new IllegalArgumentException("Field classification is unavailable"));
}
Level override = config.getClassificationOverrides().get(table.getName() + "." + field);
if(override != null)
{
return (override);
}
}
return (declared == null ? Level.PUBLIC : Level.valueOf(declared));
}
/*******************************************************************************
** Schema declarations alone cannot attest a record's classification source.
*******************************************************************************/
public static boolean hasSource(QTableMetaData table, String field, EmailQBitConfig config)
{
if(config.getClassificationOverrides().containsKey(table.getName() + "." + field))
{
return (true);
}
try
{
Class<?> core = Class.forName("com.kingsrook.qqq.backend.core.actions.ai.AiDataClassifications");
return (core.getMethod("ofField", QTableMetaData.class, String.class).invoke(null, table, field) instanceof Enum<?>);
}
catch(ReflectiveOperationException e)
{
return (false);
}
}
/*******************************************************************************
** PII has the same email approval requirement as PHI.
*******************************************************************************/
public static boolean sensitive(Level level)
{
return (level == Level.PII || level == Level.PHI);
}
}