Skip to content

Commit ff41ec0

Browse files
committed
feat: track cyphera-java 0.0.1-alpha.7 — rename policy→configuration, collapsed access API
Bumps the cyphera dependency to 0.0.1-alpha.7 (the access-collapse release). Renames property keys, system properties, env vars, and prose that still used the pre-rename "policy" / "tag" vocabulary, and updates any wrapper class / UDF names that mirrored the old SDK shape. The cyphera SDK's public surface is now just protect(value, name) + access(value) [+ access(value, name) escape hatch].
1 parent 53b5941 commit ff41ec0

4 files changed

Lines changed: 26 additions & 26 deletions

File tree

README.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -39,20 +39,20 @@ docker build -t cyphera-informatica .
3939
1. Upload `cyphera-informatica-0.1.0.jar` as a custom library
4040
2. Reference in a Java transformation within your mapping
4141

42-
### Policy Configuration
42+
### Configuration
4343

44-
Place `cyphera.json` at `/etc/cyphera/cyphera.json` or set the `CYPHERA_POLICY_FILE` environment variable.
44+
Place `cyphera.json` at `/etc/cyphera/cyphera.json` or set the `CYPHERA_CONFIGURATION_FILE` environment variable.
4545

4646
## Usage
4747

4848
In a Java Transformation expression:
4949

5050
```java
51-
// Protect with a named policy
51+
// Protect with a named configuration
5252
String protectedValue = io.cyphera.informatica.CypheraTransformation.cyphera_protect("ssn", input_ssn);
53-
// → "T01i6J-xF-07pX" (tagged, dashes preserved)
53+
// → "T01i6J-xF-07pX" (header-prefixed, dashes preserved)
5454

55-
// Access — tag tells Cyphera which policy to use
55+
// Access — the embedded header tells Cyphera which configuration to use
5656
String accessed = io.cyphera.informatica.CypheraTransformation.cyphera_access(protectedValue);
5757
// → original SSN
5858
```
@@ -61,18 +61,18 @@ String accessed = io.cyphera.informatica.CypheraTransformation.cyphera_access(pr
6161

6262
| Method | Description |
6363
|--------|-------------|
64-
| `cyphera_protect(policy, value)` | Protect using a named policy |
65-
| `cyphera_access(protectedValue)` | Access using tag-based policy lookup |
66-
| `cyphera_access(policy, protectedValue)` | Access with explicit policy name |
64+
| `cyphera_protect(configuration, value)` | Protect using a named configuration |
65+
| `cyphera_access(protectedValue)` | Access using the embedded header (primary) |
66+
| `cyphera_access(configuration, protectedValue)` | Access with explicit configuration name (escape hatch for headerless configurations) |
6767

6868
## Operations
6969

70-
### Policy Configuration
70+
### Configuration
7171

72-
- Policy file: `/etc/cyphera/cyphera.json` or `CYPHERA_POLICY_FILE` env var
72+
- Configuration file: `/etc/cyphera/cyphera.json` or `CYPHERA_CONFIGURATION_FILE` env var
7373
- For PowerCenter: set env var on the Integration Service
7474
- For IDMC: set env var in the Secure Agent configuration
75-
- Policy loaded on first call — restart the service to reload
75+
- Configuration loaded on first call — restart the service to reload
7676

7777
### Monitoring
7878

@@ -88,16 +88,16 @@ String accessed = io.cyphera.informatica.CypheraTransformation.cyphera_access(pr
8888
### Troubleshooting
8989

9090
- **ClassNotFoundException** — JAR not on the classpath. Verify placement and restart.
91-
- **"Unknown policy"**policy file not found or policy name misspelled
91+
- **"Unknown configuration"**configuration file not found or configuration name misspelled
9292
- **Java version mismatch** — this JAR requires Java 8+. Check your Informatica JRE version.
9393

94-
## Policy File
94+
## Configuration File
9595

9696
```json
9797
{
98-
"policies": {
99-
"ssn": { "engine": "ff1", "key_ref": "demo-key", "tag": "T01" },
100-
"credit_card": { "engine": "ff1", "key_ref": "demo-key", "tag": "T02" }
98+
"configurations": {
99+
"ssn": { "engine": "ff1", "key_ref": "demo-key", "header": "T01" },
100+
"credit_card": { "engine": "ff1", "key_ref": "demo-key", "header": "T02" }
101101
},
102102
"keys": {
103103
"demo-key": { "material": "2B7E151628AED2A6ABF7158809CF4F3C" }

pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@
2323
<dependency>
2424
<groupId>io.cyphera</groupId>
2525
<artifactId>cyphera</artifactId>
26-
<version>0.0.1-alpha.4</version>
26+
<version>0.0.1-alpha.7</version>
2727
</dependency>
2828
</dependencies>
2929

src/main/java/io/cyphera/informatica/CypheraLoader.java

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,16 +15,16 @@ public static Cyphera getInstance() {
1515
if (instance == null) {
1616
synchronized (CypheraLoader.class) {
1717
if (instance == null) {
18-
String path = System.getProperty("cyphera.policy.file",
19-
System.getenv() != null && System.getenv().containsKey("CYPHERA_POLICY_FILE")
20-
? System.getenv("CYPHERA_POLICY_FILE")
18+
String path = System.getProperty("cyphera.configuration.file",
19+
System.getenv() != null && System.getenv().containsKey("CYPHERA_CONFIGURATION_FILE")
20+
? System.getenv("CYPHERA_CONFIGURATION_FILE")
2121
: "/etc/cyphera/cyphera.json");
2222
try {
2323
instance = Cyphera.fromFile(path);
2424
LOG.info("Cyphera SDK loaded from " + path);
2525
} catch (Exception e) {
26-
LOG.log(Level.SEVERE, "Failed to load Cyphera config: " + path, e);
27-
throw new RuntimeException("Failed to load Cyphera config: " + path, e);
26+
LOG.log(Level.SEVERE, "Failed to load Cyphera configuration: " + path, e);
27+
throw new RuntimeException("Failed to load Cyphera configuration: " + path, e);
2828
}
2929
}
3030
}

src/main/java/io/cyphera/informatica/CypheraTransformation.java

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@ private CypheraTransformation() {}
1414

1515
private static final Cyphera CLIENT = CypheraLoader.getInstance();
1616

17-
public static String cyphera_protect(String policyName, String value) {
18-
try { return CLIENT.protect(value, policyName); }
17+
public static String cyphera_protect(String configurationName, String value) {
18+
try { return CLIENT.protect(value, configurationName); }
1919
catch (Exception e) { return "[error: " + e.getMessage() + "]"; }
2020
}
2121

@@ -24,8 +24,8 @@ public static String cyphera_access(String protectedValue) {
2424
catch (Exception e) { return "[error: " + e.getMessage() + "]"; }
2525
}
2626

27-
public static String cyphera_access(String policyName, String protectedValue) {
28-
try { return CLIENT.access(protectedValue, policyName); }
27+
public static String cyphera_access(String configurationName, String protectedValue) {
28+
try { return CLIENT.access(protectedValue, configurationName); }
2929
catch (Exception e) { return "[error: " + e.getMessage() + "]"; }
3030
}
3131
}

0 commit comments

Comments
 (0)